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Preface 


This manual is intended as a supplement to the 
ValidGED User’s Manual and ValidGED Command Refer- 
ence Manual. The features it describes are applicable 
only on the Sun Workstation™. 
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Message Window 
Popup Menu 


This section explains the Message Window Popup 
Menu. : 
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Message Window Popup Menu 


Menu On the Sun workstation, a popup menu is available 
: within the message window that provides a few 
Operations “shortcuts” to some GED operations. The main 


message window popup menu is shown below. 


GET selection 


Caret to top 


There are two methods of selection for all of the 
popup menu operations: 


© Single selection 
e Multiple selection 


Use the right mouse button to perform popup menu 
operations after either type of text selection. 
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Message Window Popup Menu 


Single selection uses the left and right mouse 
buttons: 


e Press the left mouse button to start a 
selection. 


e Press the middle mouse button to end a 
selection. 


Multiple selection uses only the left mouse button. 
The mouse button presses should be in quick 
succession. 


e Press the button once to select one character. 


e Press the button twice to select the word un- 
der the cursor. 


e Press the button three times to select the 
whole line under the cursor. 


@ Press the button four times to select the con- 
tents of the entire message window. 


The SunView function keys Put (L6), Get (L8), and 
Find (L9) operate in the standard SunView manner 
within the GED message window. 
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Message Window Popup Menu 


Stuff “Stuff” makes a copy of the selected item and in- 
serts the text as GED input. This is useful for re- 
peating commands. Another method of copying and 


repeating text is to hold down the key and 


the right mouse button at the same time. This 
t includ re . 66 ” 8 : 
ee causes the selected text to be “stuffed” immediately, 
You must enter the 


yourself. without bringing up the menu. 


You can also copy an item from other Sun windows 
and “stuff” the information into the GED window. 
You cannot, however, copy items from the GED 
window and “stuff” the information into other Sun 
windows. 


NOTE: Stuff does 


EDIT Selection Use the selected item as an argument to the edit 
command. For example, get a directory listing of 
your current directory, highlight a drawing name 
with the mouse, then pick edit selection from the 
popup menu. GED executes the edit command on 
the selected drawing. 


Note: |If you do a simple directory listing (showing the 
drawing names without extensions or version num- 
bers) and then choose edit selection from the 
popup menu, GED automatically appends a 
LOGIC.1.1 extension to the drawing name. If you 
are trying to edit a BODY drawing, you get the mes- 
sage, “New drawing started,” and GED cre- 
ates a LOGIC drawing with the same name as the 
BODY drawing. 


To avoid creating the wrong type of drawing, use the 
command directory *.* to include drawing exten- 
sions and version numbers in the listing. Then when 
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Message Window Popup Menu 


GET Selection 


ADD Selection 


Split View 


Destroy View 


Reset 
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you choose edit selection, GED opens the correct 
drawing. 


Use the selected item as an argument to the get 
command. get replaces the current copy of a draw- 
ing with the version stored on the disk. The new 
copy replaces any previously read (and perhaps 
modified) version in GED. 


Use the selected item as an argument to the add 
command. For example, list the Isttl library, high- 
light a part name with the mouse, then pick add Se- 
lection from the popup menu. GED adds the se- 
lected part to the current drawing. 


Split the message window into any number of sub- 
windows. When you enter information or when 
GED prints messages, the active subwindow(s) up- 
dates to show the current position. If you scroll 
backwards in a subwindow to a previous view, the 
previous view remains visible in that subwindow. 


If there is only one message window, destroy view 
appears on the menu in shaded gray text and is not 
available as a selection. destroy view only appears 
as a menu option if you have used the split view 
command to create a subwindow. To close a sub- 
window, place the cursor in the window and select 
the destroy view menu option. 


Clear the subwindow of its contents. If there is no 
new text in the window, the window resets immedi- 
ately. If there is new text in the window, the system 
asks you to confirm the window reset. 


Message Window Popup Menu 


Caret to Top 


Find 


Refer to the Sun manual 
Windows and Window 

- Based Tools for more 
information on the shelf 
facility. 


Save 
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Reposition the message window so the line contain- 
ing the caret cursor is near the top of the window. 
This is useful when you have been scrolling the win- 
dow and the caret is not currently visible. 


Search through the message window for the selected 
item. Find has an additional popup menu: 


Find, forward 

Find, backward 

Find Shelf, forward 
Find Shelf, backward 


Find, forward is the default. Find, backward 
searches in reverse for the selected item. Find 
Shelf, forward and Find Shelf, backward search 
forward and reverse for the text that matches what- 
ever text is currently in the cut/paste buffer. 


Save the contents of the message window to a file. 
Save has an additional popup menu: 


Save file 
Save & Quit 
Save & Reset 
Close & Save 


Store to named file 
Store & Quit 
Close & Store 
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Message Window Popup Menu 


The first four options default to shaded gray text 
and are not immediately available for selection. 
Store to named file allows you to store the contents 
of the message window to a particular file. If there 
is any selected text in the window, that text is used 
as the name of the new file. If no text is selected, 
the system requests a filename entry. 


After you select the Store to named file option, all 
the menu options are available for selection. 


e Save file writes to the current file until you 
use Store to named file to change to an- 
other file. 


e@ Save & Quit and Store & Quit save the win- 
dow contents to the current file or a named 
file and exit GED. This is an abnormal GED 
exit; these options do not allow GED to clean 
up temporary files or check to see if there are 
changes to save. 


2 Close & Save and Close & Store save the 
window contents to the current file or a 
named file and close GED to an icon. Save 
& Reset saves the window contents to the 
named file and clears the message window. 
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Customizing Menus 


This section explains: 
o Creating menus 
e Creating menu icons 


e Loading menu definition files 


2-1 


Customizing Menus 
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Note: 


On the Sun workstation, you can design custom 
menus for your own use. By changing the number 
of menu boxes and size of the menu window, you 
can have any number of commands available on a 
menu. Icons allow you to create graphic menus as 
well as command-name menu boxes. 


The Sun workstation also supports popup menus, 
which allow you to group commands and arguments 
and attach them to one menu item to simplify selec- 
tion. There can be more than one level of popup 
menu selection so you can group items as required. 
Selecting an item from the popup menu appends the 
popup item to the menu item, separated by a space. 
Any other selection (outside the popup menu), aban- 
dons the popup menu. 


On the Sun workstation, the UNIX command 
setkeys lefty makes no impression on GED. The 
command reverses the left and right function key 
positions, but the assign and show keys com- 
mands still interpret key names as though the func- 
tion keys were in their original order. 
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Customizing Menus 


Creating Menus 
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The global menu definition file, ged.menu, defines 
the default on-screen menu that you see on the 
right-hand side of the screen when you start GED. 
Only the System Manager can modify this global 
menu. 


If you want to change the default menu on your own 
GED display, there are other pre-defined GED 
menus available. All the pre-defined GED menus 
can be found in the directory: 


/usr/valid/tools/editor/menus 


Figure 2-1 shows three pre-defined GED menus, 
ged.menu, pr.menu, and gr.menu. 


You can also create your own menu definition file 
and change your startup.ged file to read in the file 
you have created. Creating a menu definition file is 
described following the figure. 
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Customizing Menus 
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Figure 2-1. Sample GED Menus 
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Customizing Menus 


The Menu Definition The menu definition file determines: 
File e 


Menu dimensions 


e Popup menus associated with any of the 
menu boxes 


e The size, location, appearance, and functions 
of the menu boxes 


Figure 2-2 shows a portion of the menu definition 
file. The backslash (\) at the end of a line indicates 
that the command line is continued on the following 
file line, and a period (.) indicates the end of a com- 
mand line. Curly braces ({ }) enclose comments, 
which are ignored by the program. 
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Customizing Menus 
FILE_TYPE = MENU_DEFN. 
dimensions (20, 3). 
assign_popup <zoom>\ 
UPTT" UPTT" ; \ 
"PREVIOUS" "PREVIOUS", \ 
" : (REFRESH) uw wt : " : \ 
"LEFT" "LEFT", \ 
"RIGHT" "RIGHT", \ 
"UP" "UP" : \ 
"DOWN" "DOWN"! ‘ \ 
"IN 1.625" "1.625", \ 


"OUT 1.625" "-~1.625",\ 
"Enter points" ""\ {let user define zoom} 


assign_box (1, 13_BOX "HELP" "HELP". 
assign_box (2, 13_BOX "SHOW" "SHOW". 
assign_box (3, 13_BOX "VERSION" "VERSION". 
assign box (4, 13_ BOX "GROUP" "GROUP". 
assign box (5, 13_ BOX "SPLIT" "SPLIT". 
assign _box (6, 13_BOX "COPY" "COPY". 

assign box (7, 13_BOX "DELETE" "DELETE", 
assign_box (8, 13_BOX "MOVE" "MOVE". 

assign _box (9, 13_BOX "WIRE" "WIRE", 
assign_box (10, 13_ BOX "ZOOM" <zoom> "ZOOM". 
assign_box (11, 13 -BOX eu tte, 

assign box (12, 13_BOX "SIGNAME" "SIGNAME". 
assign_box (13, 13 BOX "CHANGE" "CHANGE", 
assign_box (14, 13_BOX "PROPERTY" "PROPERTY". 
assign_box (15, 13_BOX "ROUTE" "ROUTE". 
assign_box (16, 13_ BOX "DIRECTORY" "DIRECTORY". 
assign_box (17, 13_ BOX "UNDO" "UNDO". 
assign_box (18, 13_BOX "REDO" "REDO". 
assign_box (19, 1) 13_BOX "Others" "", 

free_box (20, 1) 13_BOX "EDIT" "EDIT". 

end. 


Figure 2-2. Partial Menu Definition File 


1/15/89 


Customizing Menus 


Defining the File Type 


Defining the Window 
Size 


length_of_column 


# of columns 
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The first and last lines of the definition file are re- 
quired. The first line tells GED what type of file this 
is; the last line defines the end of the file. 


FILE TYPE = MENU_DEFN. 


end. 


The dimensions statement specifies the overall size 
of the menu window. 


dimensions /ength_of column, window_wiadth 


The number of menu boxes in a column. The maxi- 
mum number of boxes per column varies depending 
on the size of the menu boxes. 


Width of the menu window. 


dimensions (20, 8). 
The default window dimensions for ged.menu. 


dimensions (20, 5). 
The window dimensions for gr.menu and pr.menu. 
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Customizing Menus 


Defining the Popup Any menu boxes that require associated popup 
Menus menus must be defined. 


SYNTAX : 


osarateseseveseusieteecevertre yeasts taaeertotonmaesecee eae 


assign_popup <popupname> "send_string" "show_string", 


< popupname > The name of the popup menu. The popupname can 
be any name up to 24 characters long. It must be 
enclosed in angle brackets. 


"show_string" The text to display on the screen. There is a maxi- 
mum of 80 characters per show_string. 


"send_string" The command string to send to GED. There is a 
maximum of 256 characters per send_string. 


There must be one send_string~show_string pair for 
each item that appears in the popup menu. Sepa- 
rate the pairs with a space and the items with com- 
mas. End the entire popup definition with a period. 


A menu box that has an associated popup menu 
automatically displays an arrow on the right-hand 
side of the box. 


assign _popup <zoom>\ 
OPIT" "PIT", \ 
"; (REFRESH)" ";",\ 
"LEFT" "LEFT", \ 
"RIGHT" "RIGHT", \ 
"IN 1.625" "1,.625",\ 
"OUT 1.625" "-1.625",\ 
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Customizing Menus 


Defining the Menu There are two types of menu boxes: 
Boxes 


e Static function 
e Variable function 


Static function boxes are assigned specific functions. 
They can send command strings to GED or display 
popup menus. Static functions can be changed only 
with the assign_box statement. Most of the boxes 
in the menu window are static function boxes. 


Free boxes are assigned functions as you issue GED 
commands during an editing session. If you use a 
command that is not already assigned to a static 
function menu box, the command is assigned to a 
free box. If all the free boxes are assigned com- 
mands and you use a command not assigned to a 
menu box, that command replaces the function in 
the least recently used free box. 


Lines beginning with the assign_box statement de- 
fine static function menu boxes; lines beginning with 
the free_box statement define variable function free 
boxes. The command arguments are the same for 
both types of boxes. 


assign_box ( row,col ) size menu_entry 
free_box ( row,col ) size menu_entry 


g 
F3 
Fe 


i 
+ 
= 
2 
$ 
a 
Se 
yi 
* 


SYNTAX 


( row, col ) The location of the box in the menu window, count- 
ing from (1, 1) in the upper left corner of the win- 
dow. At least one menu box must be defined with a 
row number of 1. The maximum number of boxes 
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Customizing Menus 


per column varies depending on the size of the 
menu boxes. 


When you assign boxes to rows and columns, you 
can place boxes next to each other or you can over- 
lap the rows and column of boxes. Figure 2-3 
shows a menu configured with overlapping boxes 
and one defined with adjacent boxes. Since overlap- 
ping boxes can be difficult to read, you should plan 
your menu layout to avoid confusion. 


}|[DISPLAY AL} 


CC 


ROUTE QUIT 


Figure 2-3. Overlapping and Adjacent Menu Boxes 


WIRE : 
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Customizing Menus 


size The size of the menu box. There are four 
predefined menu box sizes, as shown in Figure 2-4. 
If you enter an illegal box size, the menu box de- 
faults to a 22 BOX. 


Size in Pixels Size in Menu Maximum Boxes 
(h x w) Units (h x w) per Column 


27 X 126 


Figure 2-4. Menu Icon Box Sizes 
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Customizing Menus 


menu_entry 


"text_label" 


<icon_file> 


<popupname> 


"send_string" 


The menu_entry consists of the text or icon to display 
on the menu box, an optional popup menu name, 
and the command string to send to GED. The 
menu_entry format is: 


"text_label" <popupname> "send_string", 


or 
<icon_file> <popupname> "send_string", 


A text string of up to 80 characters to display in the 
menu box. The text_label must be enclosed in quo- 
tation marks. 


The name and full directory path of a file defining 
an icon to display in the menu box. An icon_file 
must be enclosed in angle brackets; do not enclose 
an icon_file in quotation marks or it will be inter- 
preted as a text string. You can use an icon_file 
definition from any directory as long as the directory 
pathname is included in the icon_file definition. 
You cannot create icons in the default icon direc- 
tory; see Creating Menu Icons, page 2-14, for infor- 
mation on designing your own menu icons. 


The name of a previously-defined popup menu to 
access when you select the menu box. The 
popupname must be enclosed in angle brackets. 


The command string to send to GED when the menu 
box is selected. The complete string, including 
strings appended through popup selections, can have 
a maximum of 256 characters. 
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assign box (1, 1) 28 BOX "HELP" 
"HELP". 


assign_box (15, 1) 22 BOX \ 
</icons/section.icon> "SECTION". 


asSign_box (18, 2) 22 BOX \ 
</usr/catie/test.icon> "", 


assign _ box (2, 3) 13 BOX \ 
"show" <show> "show". 


free box (20, 1) 14 BOX \ 
“edit -“reqit™.. 


free box (24, 2) 14 BOX \ "HN, 


Customizing Menus 


Creating Menu 
Icons 


The directory /usr/valid/tools/editor/menus/icons con- 
tains the files for any icons predefined for your sys- 
tem. This is a read-only directory; you cannot write 
icon files to this location. You must create new icons 
in another directory. 


A menu definition file can include icons from any 
number of directories as long as the directory path 
is included in the assign _box statement for the 
icon. 


To have the menu box border around any icons you 
create, the menu box templates must reside in the 
directory where you are creating icons. 


To create a new icon: 
1 Copy the menu box templates from the 


/usr/valid/tools/editor/menus/icons directory into 
the directory where you are creating icons. 
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Customizing Menus 


2 Select the IconEditor from the Suntools 
menu. The IconEditor form is displayed. 


oS aig hs aaa Meee “ BREN ae Sa eRe eee ase” 


dconedi tec 


@ Paint @ clear @ Undo 
Points: Pick points to Paint or Clear. 


Size ¢ Icon Grid OS Off 


Fill & Border 
Fill 2 Border 


Fill: 


Fill Proof 
“Sree CSSre 


Ob @ He 


Figure 2-5. The IconEditor Form 


3 Change to the directory where you want your 
icons to reside. Use the key to re- 
move the directory name at the top of the 
form, and type in the new directory name. 
As you enter characters, the beginning of the 
entry disappears to the left. | 
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Customizing Menus 


4 Select the Browse box with the mouse to see 
the existing icons in the current directory. 
System messages state the number of files 
found in that directory and how many icon 
images are being loaded. A new window dis- 
plays the image icons. 


5 Use the mouse to select the template you 
want to use. The icon image window disap- 
pears, and the template icon appears for 
editing. 


6 Select the File line (below the directory 
name) with the mouse. Delete the existing 
file name and type in a temporary name to 
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Customizing Menus 


assign to your new icon (see below). Include 
the .icon file extension. 


¢ Create your icon, then select the Store box to 
save the icon. 


8 Select the Quit box to exit the editor. 


The menu system does not add an arrow symbol to 
menu boxes read from an icon file even if the box 
has a popup associated with it; menu icons are dis- 
played as defined. You can include an arrow sym- 
bol, when appropriate, in the corner of icons that 
you create. 


Next you need to resize the new icon for use in the 
GED menu. The fixicon command is used to cor- 
rect the icon dimensions. The fixicon command is 
located in the  /usr/valid/tools/editor/menus/icons 
directory. 


SYNTAX 


a“a‘a%a"s"a"s"a‘ate’a*e's"ota"e"s*e"ofeta'v’atetete‘s'aterbratetereeteten: 


fixicon temporary.icon menu.icon 


temporary.icon The temporary name of the icon you created with 
the Icon Editor. 


menu.icon The actual name of the icon to include in the GED 
menu. 


fixicon xxx.icon grid.icon 


EXAMPLE f 
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Loading Menu 
Definition Files 


A menu definition file is loaded with the loadmenu 
command. This command may be typed in the GED 
message window or it may be included in your 
startup.ged file so that your menu is loaded when 
you enter the editor. In either case, the menu defi- 
nition file must be in the correct format and must 
have a name ending with a .menu extension. 


You can load menus on either side of the drawing 
area. The right-side menu is the default. The com- 
mand loadmenu left loads the menu on the left side 
of the screen. If no menu position is specified, the 
new menu is loaded on the same side as the current 
menu position. 


When you specify the name of the file containing 
the desired menu, include the .menu filename exten- 
sion. If it is not present, you get an error message 
and no menu is loaded. 
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buttons, mouse, 1-3 : : 
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destroying subwindows, 1-5 


C directory command, 1-4 
caret to top operation, 1-6 discarding drawing changes, 1-5 
changes, discarding, 1-5 drawing name extensions, 1-4 
; drawings 
clearing subwindows, 1-5 discardineschanves, 425 
commands, repeating, 1-4 reading from disk, 1-5 
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menus, 2-5 edit selection operation, 1-4 
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Index 


F L 
files left mouse button, 1-3 
ged.menu, 2-3 library parts, adding, 1-5 


menu definition, 2-5 to 2-13 
startup.ged, 2-3 


find operation, 1-6 M 
SunView, 1-3 menu 
box placement, 2-10 
: default, 2-4 
function keys, SunView, 1-3 definition file, 2-5 to 2-13 
global, 2-3 
loading, 2-18 
G definitions, 2-9 
popup menus, 2-8 
icons, 2—J1 
creating, 2-14 to 2-17 


free menu boxes, 2-9 


GED commands 


add, 1-5 selecting popup menu items, 1-2 
directory, 1-4 window, 2-3 

edit, 1-4 defining size, 2-7 

get, 1-5 


message window popup menu 
ged.menu file, 2-3 add selection, 1-5 
caret to top, 1-6 


get operation, SunView, 1-3 destroy view, 1-5 


get selection operation, 1-5 edit selection, 1-4 
Antone find, 1-6 
global menu definition file, 2-3 get selection, 1-5 
reset, 1-5 
save, 1-6 to 1-7 
| selecting menu operations, 1-2 
| split view, 1-5 
Icon Editor, 2-15 stuff, 1-4 
‘ong. denice mouse button operations, 1-3 
creating, 2-14—2-17 multiple item selection, 1-2 to 1-3 
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P 
placing menu boxes, 2-10 


popup menus, defining, 2-8, see also 
message window popup menu 


put operation, SunView, 1-3 


R 


reading drawings from disk, 1-5 
repeating commands, 1-4 
repositioning message window, 1-6 
reset operation, 1-5 

resetting subwindows, 1-5 


right mouse button, 1-2, 1-4 
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save operation, 1-6 to 1-7 
scrolling subwindows, 1-5 
search, message window, 1-6 
selecting menu operations, 1-2 
single item selection, 1-2 to 1-3 
split view operation, 1-5 
startup.ged file, 2-3 

Static function menu boxes, 2-9 
stuff operation, 1-4 
subwindows, 1-5 

Suntools Icon Editor, 2-15 
SunView function keys, 1-3 


T 


text, copying, 1-4 


W 


windows, defining size, 2-7 
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Introduction 


The topics covered in this manual include: 
e An overview of GED 
e The GED editing environment 
‘e Creating and printing a design using GED 
e Drawing Maintenance 


e GED Files 
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Introduction 


The Graphics Editor, GED, is the primary interface 
between you and your Valid system. GED allows 
you to represent your logic designs from initial con- 
cept to completion of the detailed circuit description. 


GED includes features and commands specifically 
developed for drawing schematics: 


e Extensive component libraries for the most 
commonly used logic families are available 
for access through the editor. GED also pro- 
vides facilities for designing and creating 
your own bodies or symbols that can be 
added to a drawing or component library. 


e The interconnecting (wiring) of component 
bodies is done with conventional orthogonal 
(bent) wires. Direct (diagonal) wires are also 
available. 


e A special feature called dynamic dragging al- 
lows bodies to be moved in real time; wire 
connections are maintained when bodies are 
moved. 


e Body versioning and rotating are supported. 


e Properties can be assigned to bodies or wires 
to specify circuit attributes. 


e Notes can be added to document the 
schematic. 
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Also, GED is designed for versatility and ease of 


e A full complement of commands allows you 
to efficiently enter and modify the schematic. 


e Commands can be entered from the keyboard 
or selected from a convenient on-screen 
menu. 


e Function keys can be programmed to perform 
commonly-used commands. 


e Variable scaling, panning, and zooming func- 
tions allow you to view precise portions of the 
drawing. 


e The default operations of the editor can be 
changed to meet your specific requirements. 


e undo and redo commands can be used to re- 
store a drawing to any previous state. 


e In the case of a power failure, automatic re- 
covery of a drawing can be initiated. 
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Introduction 


GED Overview 


The Editing Environment 


Creating a Design 


Design Techniques 


Producing a Hardcopy 


Adding Physical Information 


Mixing Text and Graphics 


Drawing Maintenance 


GED Files 
Hardcopy Fonts 


Batch and Nongraphical GED 


This document describes the features and applica- 
tions of GED. These sections are included: 


General information about using GED and your 
workstation. 


The file and directory structures used by GED; 
working efficiently in the GED editing environment. 


Using GED commands to create a schematic. 


Using GED to create hierarchical and structured 
designs. 


Making a plot of your schematic. 


Adding information about physical part assignments 
to your logical design. 


Using GED to produce a mixed text and graphics 
document. 


Updating drawings and recovering from system 


| failures. 


The format of the files created and used by GED. 
Illustrations and ASCII codes for supported fonts. 


Nongraphical GED and file redirection. 
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Manual Set 


Documentation 


Conventions 


Convention 


bold font 
[optional] 


keyname 


italic font 


1/15/89 


Meaning 


In addition to this manual, information on GED can 
be found in the following manuals: 


e ValidGED Command Reference Manual 

e Using ValidGED on Your Sun Workstation 

e ValidGED Tutorial I: Logic Design 
Figure 1 lists the documentation conventions used in 
this manual. The UNIX operating system distin- 
guishes between uppercase and lowercase letters, 
and UNIX commands are normally entered in lower- 


case letters. UNIX commands must be entered 
exactly as they appear in the text. 


Example 


Literal keyboard input set path = 


Optional user input; brackets [-options] 
are not entered 


Name of key or button the a 


user should press 


Variables; must be replaced by user_name 
specific values supplied by the 
user 


Figure 1. Documentation Conventions 


* On the PC AT platform, the key is 
labelled CEnter J. 


GED Overview 


This section introduces general information about 


using GED and the workstation: 
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Command conventions 

Access and exit procedures 

Elements of the screen 

The keyboard and default function keys 
The cursor controller 


On-line help 
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GED Commands 


File names and text 
added to drawings are 
case-sensitive. 


GED creates logic drawings (schematics) and body 
drawings (shapes of parts) using a high resolution 
CRT display, alphanumeric keyboard, and cursor 
controller. In addition to creating and modifying 
drawings, GED interacts with the operating system 
to retrieve and store drawings. 


Commands are issued to GED using both the on- 
screen menu and the keyboard. These commands 
allow you to place bodies on the drawing, connect 
pins with wires, add text information (such as signal 
names and notes), and manipulate the information 
contained in the drawing. 


GED is case-insensitive and recognizes commands 
typed in either uppercase or lowercase letters. 


GED commands are structured so that the system 
recognizes both the complete command name and 
the smallest unique portion of the command name. 
For example, the edit command can be issued by 
typing any of the following: © 


EDIT 
edit 
EDI 
ed 


Refer to the ValidGED Command Reference Manual 
for an alphabetical reference of all GED commands. 
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Follow these procedures to start the Graphics Editor 
and edit a drawing: 


Accessing GED 


On a SCALDsystem, you need 1 Turn on your workstation and log in. 


one large window. Refer to 
the System Utilities Reference 
Manual for information about 
creating windows on a 
SCALDsystem. 


Refer to Section 3, The 
Editing Environment, 
for more information 
about directory and 
drawing names. 


EXAMPLES | 
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2 Make sure you are in your own login direc- 


tory or in the appropriate project directory. 


At the prompt, type: 


ged 


You can enter the name of the drawing as an 
option to the ged command. If the drawing 
name contains spaces or other special charac- 
ters, such as angle brackets (< >), place ane 
tation marks around the name. 


ged "<scald_dir>cpu board. logic.1.2" 


ged counter 


To begin working on a drawing, type: 


edit drawing_name 


drawing_name is the name of the drawing 
you wish to edit. If the drawing exists, GED 
accesses the appropriate drawing file and dis- 
plays the drawing on the screen. If you are 
creating a new drawing, a blank page is 
displayed. 
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Exiting GED The following procedures describe the two ways to 
exit from GED and return to the system prompt: 


Exit and Save | To exit from GED and save your current drawing: 
1 Type: 
write 


2 Type: 


exit 


or 


quit 


to return to the system prompt. 


Exit without Save | To exit from GED without saving changes in your 
current drawing: 


1 Type: 
exit 
or 


quit 


GED prompts you if there are unwritten 
changes to any drawings you were editing. 


2 Retype the command and press to 
override the warning, discard the changes, 
and exit from GED. 
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The GED Screen 


Valid Graphics’ Editor: (GEN). 9.68: - 


Status Line 


Message Window PROPERTY 


OTRECTORY..) 


Valid Logic Systems, Inc. Graphics Editor 
49.28 


: “a RE ec PE he PR RS ES CP EN IL eae SAR REC ROU EPR To EEE a 
UNNAMED. LOGIC. 1. 1 GRID 8.1 S CATIE. WRK 


After you issue the ged command, the GED win- 
dow, cursor, on-screen menu, status line, and mes- 
sage window are displayed on the = screen. 
Figure 1-1 shows a typical GED screen display. 
There may be minor differences in the screen dis- 
play on different hardware platforms. 


If you specified the drawing name on the command 
line, that drawing is displayed on the screen. 


i 
= 
j &: 
- we 


A delat (illilititali 


sun3-B3 beaucoups Thu Nov 17 17:86:42 PST 1988 


Bi New drawing started 


Figure 1-1. Typical GED Screen 
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GED Cursor 


On-Screen Menu 


Status Line 


The GED window includes these four items: 


e Cursor 
e Command menu 
e Message window 


e Status line 


The cursor appears as a cross on the screen. You 
move the cursor by moving the puck or mouse (cur- 
sor controller). You can select a command from the 
menu or an object to be changed by pointing to the 
item and pressing one of the buttons on the cursor 
controller. You also use the cursor to wire compo- 
nents, draw lines, position library parts, and move 
items on drawings. 


A menu of frequently-used commands appears along 
the right side of the screen. Most of the command 
names are self-explanatory. The semicolon (;) on 
the menu is used to end commands. Some of the 
boxes on the menu may be free boxes, where the last 
commands issued from the keyboard are displayed. 
The currently-active command is highlighted. The 
menu and loadmenu commands allow you to deter- 
mine which commands are displayed on the menu. 


The status line is displayed at the top of the screen. 
This line tells the name of the drawing currently be- 
ing edited, the grid setting, and the name of the cur- 
rent working directory. 
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Message Window 


If you make a mistake during 
command entry (before press- 
ing ), you can correct 
it by using the backspace key 
and retyping the command 
correctly. 


Program Messages 
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At the bottom of the screen is the message window. 
This is where you type in commands and receive 
status messages from GED. 


GED output that requires more than one message 
window page pauses after each page and inquires: 


More? [ync] 


The possible responses are: 


y Yes. Present more information. 
n No. Do not print any more output. 
Cc Continue. Print the entire message out- 


put without pausing for page prompts. 


You can also respond q (for quit), which acts like a 


no response, or you can enter a , which acts 
like a yes response. 


You can resize the drawing and message windows 
within the GED frame. Grab the border between the 
message and drawing windows, press the middle 
mouse button, and move the border up or down to 
resize the windows. (On the Sun system, press the 


key and the middle mouse button simulta- 


neously to resize the windows.) 


GED informs you when some operations such as 
write, group, and check are complete and lists in- 
formation requested by commands such as set, 
library, directory, and show. GED also displays 
informational messages to let you know when it can- 
not interpret or perform a command you entered. 
Messages are displayed in the message window. 
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Grid Display 
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GED uses a grid to define where objects can be 
placed on a drawing. When you first access GED, 
the grid display is turned off. 


The grid command is a toggle command. Typing: 


grid 


turns the grid off if it is already displayed, or on if it 
is currently not displayed. The command: 


grid on 


always turns the grid display on. The command: 


grid off 


always turns the grid display off. 


The default grid setting is displayed on the status 
line: 
5 
E 


0.1 
Grid points are placed y \ very fifth point 
every .1 inches. is visible. 


To change the default grid size, use the command 
set default_grid. 


Valid component libraries depend on the default 
grid setting to function properly. The grid for body 
drawings is changed to a setting that is twice as fine 
as the default grid. You should use caution when you 
change the default grid setting; bodies could be placed 
off the grid and wires might not be connected. 


1/15/89 


GED Overview 


The Keyboard 


The number keys on the 
numeric keypad of the 
VAX workstations are 
named KO through K9. 
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The keyboard is a standard alphanumeric keyboard 
with programmable function keys. The function 
keys on your keyboard are predefined with the most 
commonly used GED commands. The primary pur- 
pose of the keyboard is to allow you to type com- 
mands, signal names, properties, notes, and other 
text information required to create a drawing. The 
programmable function keys allow you to enter com- 
mands with a single keystroke. 


You can change the default function key assign- 
ments or program additional function keys with the 
assign command. Refer to the assign command 
description in the ValidGED Command Reference 
Manual for more information. 


To see the function key assignments programmed 
for your system, type: 


show keys 


Table 1-1 lists the default function key assignments. 


GED Overview 
Table 1-1. Default Function Keys 


- Sun_| Seale | Pe AT | VAX _{|___esoripon 


help — Display the on-line help screen 


window fit - Redisplay the drawing to fit 
the screen 


display both - Display the name and 
value of the selected properties 


show attach - Display attachments be- 
tween properties and objects 


window ; - Refresh the screen 


show prop - Display the name and 
value of all properties 


directory — List the drawings in the cur- 
rent directory 


display 1.25 - Enlarge selected text 25% 
display 0.8 - Reduce selected text 80% 
hardcopy - Plot the current drawing 


undo - Undo previous operation(s) 


redo - Redo previous undo operation(s) 


auto path - add path properties to a 
drawing 


check —- Examine drawing for errors 
error — Display errors located by check 


return — Display a previously—edited 
drawing 


edit -— Enter the edit command 
bubble - Bubble the selected pin 
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On the numeric keypad of the Sun workstation and 
the SCALDsystem, several keys perform different 
functions when pressed with the key. 
These shifted function keys are all Zoom command 
functions. The keys are shown in Table 1-2. Use 
the show keys command to be sure the function 
keys have not been reassigned. 


Table 1-2. Shifted Function gal 


[sun [ Sent 


zoom fit Redisplay the drawing to fit the screen 


zoom up Reposition the center of the screen up 
above the drawing (move the drawing 
down on the screen) 


previous | Switch from the current zoom scale/po- 
sition to the previous zoom scale/position 


left Reposition the center of the screen to the 
left of the drawing (move the drawing 
right on the screen) 


Refresh the screen 


Reposition the center of the screen to the 
right of the drawing (move the drawing 
left on the screen) 


Reduce the size of the drawing on the 
screen 


Reposition the center of the screen down 
below the drawing (move the drawing up 
on the screen) 


Enlarge the size of the drawing on the 
screen 
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Several keyboard characters perform different func- 


tions when pressed with the key. 


Table 1-3 describes these terminal characters and 


their operations. The key also performs a 


special function on some keyboards. 


Table 1-3. Control and Delete Key Operations 
PC AT and SCALDsystem 


Interrupt the current GED operation 
Redisplay the current input line 
Back up to the beginning of the current line 


Back up to the beginning of the previous word 


VAX Workstations 


Interrupt the current GED operation 
Redisplay the current input line 
Erase the current line 


Erase the previous character 


Sun Workstations 


Interrupt the current GED operation 
Redisplay the current input line 
Back up to the beginning of the current line 


Back up to the beginning of the previous word 


Erase the previous character 
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Cursor 
Controller 
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On the SCALDsystem and Sun workstations, all of 
these characters can be reassigned. Use the com- 
mand stty all to determine the character assign- 
ments. On the PC AT, you cannot change the 
word-erase and reprint-line functions. On VAX 
workstations, none of these functions can be 
reassigned. 


The actual type of cursor controller you use to move 
the cursor and issue commands to GED depends on 
the hardware options purchased with your Valid sys- 
tem. Whether you have a puck or a mouse, the but- 
tons are used to select commands or specify points 
on the drawing. The actual operation performed de- 
pends on the command being issued, the position of 
the cursor, and the particular button that is pressed. 


The puck has four buttons: yellow, white, green, and 
blue. A mouse has three buttons: the left button 
performs the same operation as the yellow button, 
the center button performs the same operation as 
the white button, and the right button performs the 
same operation as the blue button. In this manual, 
the buttons are referred to by color. 


To select a command from the menu, simply posi- 
tion the cursor in the box containing the command 
and press any button. To indicate “points” in your 
drawing to GED commands, you must press specific 
buttons. GED’s interpretation of a point depends on 
which command is executed and which button is 
pressed. Buttons are pressed and immediately 
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released. GED does not require buttons to be held 
down during operations. 


The yellow and white buttons use the nearest grid 
intersection as the point for the operation being per- 
formed. The blue and green buttons refer to the 
vertex, or attachment point, of the nearest object. 


For example, if you start a wire with the yellow but- 
ton, GED places the beginning of the wire at the 
grid point nearest to the cursor. To start a wire ona 
vertex, use the blue button. One press of the blue 
button snaps to the nearest vertex of an object or 
wire endpoint. 


When you use the wire command, pressing the 
white or green buttons changes the direction of a 
wire. 


For other commands, the white and green buttons 
operate on the nearest defined group; the blue and 
yellow buttons operate on the nearest individual 
object. . 


Figure 1-2 shows the mouse and puck cursor con- 
troller buttons and their operations. 
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Selects commands 

Selects items to be edited 

Attaches items to nearest grid point 
Picks up items 

Starts wires at the nearest grid point 


Yellow Button 


White Button Operates on groups 


Toggles through wire and zoom 
command options 


Rotates bodies in the add command 


Blue Button Attaches items at the nearest vertex 
Picks up items at the nearest vertex 
Starts wires at the nearest vertex 


Selects nearest object for group and 
select commands 


Pans during zoom command 


Green Button a5 Operates on groups 


Toggles through wire and zoom 
command options 


Figure 1-2. Cursor Controller Operations 
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On-Line Help 


For more information on 
the window command, see 
Section 3, Creating a 
Design, or refer to the 
ValidGED Command 
Reference Manual. 


On-line help is provided for each GED command to 
allow you to use GED efficiently. The top command 
on the GED menu is help. 


To get help on a command: 
1 Select help from the menu. 


2 Select a topic (command) from the menu 


with the cursor or type the command name 


on the keyboard and press (Return). 


When help is displayed, you can use the window 
command to enlarge the text in small windows. For 
instance, to enlarge the text by 25%, use the 
command: 


window 1.25 


There are three ways to display a list of the com- 


mands for which help is available: 


e Move the cursor to the help menu and press 
the yellow button twice. 


e Type: 
help 
e Type: 


dir <help>* 


To exit from the help command, type or select any 
GED command except window. 
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The Editing 
Environment 


This section explains: 


e SCALDsystem default files 


SCALD directory system 
@ File and drawing names 
eo Basic drawing operations 


e Creating a new project directory 
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The Editing Environment 


SCALDsystem 
Default Files 


Command Files 


startup.ged 


compiler.cmd 
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GED drawings are stored in the operating system in 
a series of related files that make up a design data- 
base. The SCALDsystem software allows you to lo- 
cate, store, and manipulate entire drawings using 
GED commands. The directory system and tools 
you use to create, store, and manage drawings and 
files is called the editing environment. Since compo- 
nent libraries are also stored in the system in the 
form of GED drawings, library access is also per- 
formed in the editing environment. 


Command files, data files, and SCALD directories 
are the three file types that help you access GED 
and the other Valid design tools. These files are 
automatically created in your login directory when 
your user account is created. 


The following command files are automatically cre- 
ated when your user account is created. 


This file specifies the libraries and SCALD directo- 
ries that you want to access automatically each time 
you run GED. You can also enter other GED com- 
mands into this file to tailor the default GED envi- 
ronment to your needs. The startup.ged file is dis- 
cussed in greater detail on page 2-5. 


This command file contains the directives for the 
Compiler. The Compiler prepares your design for 
further analysis and _ processing. See the 
ValidCompiler Reference Manual for additional infor- 
mation on the Compiler. 
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packager.cmd 


Data Files 
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simulate.cmd 


verifier.cmd 


td.cmd 


master.local 


This command file contains the directives for the 
Packager. The Packager tests your design for load- 
ing violations and wiring errors, prepares your de- 
sign for use by a physical design system, and creates 
the back annotation file read by GED. See the 
ValidPackager Reference Manual for additional infor- 
mation on the Packager. 


Depending on the Valid tools included in your sys- 
tem configuration, the following command files may 
be included in your user account. 


This command file contains the directives for the 
Logic Simulator. The Simulator performs detailed 
simulation of your design at the component level. 


This command file contains the directives for the 
Timing Verifier. The Timing Verifier analyzes par- 
tial or complete designs for timing errors. 


This command file contains the directives for the 
PLOTTIME program. The PLOTTIME program 
plots waveform diagrams created by the Simulator 
and Timing Verifier. 


The following data files are automatically created 
when your user account is created. 


This file contains an optional list of abbreviations 
and pathnames for the SCALD directories you want 
to access during a design session. The master.local 
file is discussed in greater detail on page 2-5. 
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case.dat 


delay.dat 


SCALD Directories 


SCALD directory files end 
with a .wrk extension in 
your directory listing. 


Depending on the Valid tools included in your sys- 
tem configuration, the following data files may be 
included in your user account. 


This file contains data for the Timing Verifier when 
you want to test the timing for specific cases. 


This file is used to feedback delay information to the 
Timing Verifier from a physical design system. 


Each drawing you create is stored as a group of re- 
lated drawing files in an operating system directory 
that is referenced in a special file called a 
SCALD directory. GED automatically manages 
drawing storage and retrieval operations through this 
special file. 


The SCALD directory is actually a file that maps 
GED drawing names to the operating system file 
names where the drawing is stored. The SCALD 
directory serves two purposes: 


e It allows you to refer to drawings by their 
drawing names rather than by their system 
names (which may be more cryptic). 


e It does not require you to learn system- 
specific file naming conventions (which are 
handled automatically). 


The SCALD directories make the file system trans- 
parent to you. SCALD directories are discussed in 
greater detail later in this section. 
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The Startup.ged File 


The assign and set 
commands are described 
in detail in the 
ValidGED Command 
Reference Manual. 


The Master.local File 
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The default startup.ged file contains only one com- 
mand: use username.wrk. This command creates 
a SCALD directory, username.wrk, the first time you 
write a drawing. When you edit this file: 


e Add only one command per line in the file. 
When defining libraries, use a separate 
library command for each library to be 
accessed. 


e Unlike the other command files, do not add 
the word end to the end of the file. 


Other commands you can add to this file include 
assign (to assign a function key operation) and set 
(to set a default option such as turning the grid on or 
using filled dots). Although you can enter com- 
mands directly from GED, placing commands in the 
startup.ged file automatically executes the com- 
mands each time you enter GED. You use a text 
editor to edit this file. 


The master.local file in your directory allows you to 
associate short names for SCALD directories with 
their corresponding full file specifications or path- 
names. The masterlibrary command, which you en- 
ter in your startup.ged file, specifies the name and 
location of the master.local file. 


After editing the master.local file and adding your 
defined short names, you can specify these short 
names whenever you use commands that require the 
specification of a SCALD directory, such as use, 
ignore, library, and write. 
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The format of the default master.local file is shown 
in the example in Figure 2-1. 


FILE TYPE = MASTER_LIBRARY; 


"susan .wrk" “susan .wrk’ ; 
{"projl.wrk" “[ .projl]jprojl.wrk’ ;} 
END. 


Figure 2-1. Default Master.local File 


The FILE_TYPE line must include spaces around 
the equal sign. Your user name appears instead of 
susan. Double quotes surround the full name of the 
file; single quotes surround the abbreviation. The 
third line contains an example (shown as a comment 
line enclosed in curly braces) for a hypothetical 
SCALD directory, called projl.wrk, located in the di- 
rectory projl just below the login directory. You can 
specify both full and relative pathnames for the 
SCALD directories you want to access. You can 
also use network facilities to access SCALD directo- 
ries on other workstations. 
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SCALD 
Directories 
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The SCALD directory is a file that GED uses to lo- 
cate your drawings in the operating system. GED 
automatically updates this file each time a new 
drawing is written. For each drawing, GED also cre- 
ates a separate drawing directory that contains the 
files that describe the drawing. 


A SCALD directory name is specified as a name 
and an extension. You can use any combination of 
alphanumeric characters for the name and extension 
strings. By convention, the name is the same as the 
Operating system directory and the extension is 
either .wrk (for a user directory) or .Jib (for a library 
of components). Although you are not required to 
match the directory name and use the .wrk and .lib 
extensions, this convention makes SCALD directo- 
ries readily visible in the directory listing. 


A SCALD directory is automatically created in your 
current directory when you save your first drawing 
with the write command. The name of the SCALD 
directory is determined by a line in the startup.ged 
file: 


use username .wrk 


or by issuing a use command from within GED. 


Figure 2-2 shows a sample SCALD directory. 
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UE it 


FILE TYPE = LOGIC _DIR; 
"SHIFT REGISTER" ‘“shiftregister’; 


"MEMORY SELECT LOGIC" ‘mmrySlectlogic’; 
"32-BIT ALU" “32bitalu’; 
END. 


Figure 2-2. Sample SCALD Directory 


The first line of the file identifies the directory type 
(FILE_TYPE = LOGIC_DIR;). When GED cre- 
ates a drawing directory, it is a LOGIC directory. A 


There are other directory LOGIC directory contains the drawings you create. 
ie used vi aaa This is the default directory type. Drawings of any 
iming verification, see é : 
Valid(COMPILER Reference type (LOGIC, BODY, etc.) can be placed in a 
Manual for details. LOGIC directory. 


In any SCALD directory listing, the GED drawing 
name appears on the left in uppercase letters and 
enclosed in double quotes. (Remember that GED 
drawing names are not case-sensitive.) The system 
directory where the drawing is stored appears on the 
right enclosed in single quotes. 


In the example, the drawing named MEMORY 


In VMS, the directory name SELECT LOGIC is stored in the UNIX directory 
is MMRYSLECTLOGIC.DIR. mmryslectlogic. 
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Each time you save a new drawing with the write 
command, GED creates an entry in the appropriate 
SCALD directory with your name for the drawing 
and creates the drawing directory where the drawing 
is stored. The name of the drawing directory is the 
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UNIX: 
VMS: 


UNIX: 
VMS: 


UNIX: 
VMS: 


UNIX: 
VMS: 


See Section 8, Drawing 
Maintenance, for information 
on the GED update facility. 
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GED drawing name, automatically shortened to 14 
characters, with special characters removed. Each 
drawing directory contains the following set of files: 


logic.1.1 
LOGIC$1$1.DAT 


The graphic information in ASCII format; the file is 
read by GED. 


logic_bn.1.1 
LOGIC_BN$1$1.DAT 


The graphic information in binary format; the file is 
read by GED. 


logic_cn.1.1 
LOGIC_CN$1$1.DAT 


The connectivity file that contains information about 
the parts and interconnections in the drawing; the 
file is read by the Compiler. | 


logic_dp.1.1 
LOGIC_DP$1$1.DAT 


The dependency file that lists each part used in the 
drawing and its library directory; the file is used by 
the GED update facility to ensure that the parts in 
the drawing are current. 
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Listing Directory 
Information 


directory 
directory * 


directory <*> 


directory <Isttl>* 


directory sh* 


directory *.body.* 


directory <*>* 


directory *.* 
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Within GED, the directory command lists informa- 
tion about active SCALD directories. An active 
SCALD directory is one you have accessed through 
a use or library command in your startup.ged file or 
during the current GED session. 


You can list SCALD directories and related draw- 
ings, and you can list the contents of a specific 
SCALD directory. The following examples illustrate 
some of the ways you can use the directory 
command: 


List all drawings in the current SCALD directory. 
Same as directory. 


List all active SCALD directories (but no drawing 
names). 


List all drawing names (parts) in the Isttl library. 


List all drawing names beginning with sh in the cur- 
rent SCALD directory. 


List all .body drawings in the current SCALD 
directory. 


List all drawings in all active SCALD directories. 


List the name, type, and version of each drawing in 
the current SCALD directory. 


In the examples, the asterisk (*) is a wildcard char- 
acter that matches all character strings. 
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Specifying SCALD 
Directories 


Creating A Search 
Stack 
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The use command entered in the startup.ged file can 
also be issued from within GED to specify a SCALD 
directory. When the SCALD directory to be used is 
not in your current directory, you must specify the 
full pathname or file specification of the “target” 
SCALD directory. 


Alternately, you can use the masterlibrary com- 
mand in your startup.ged file to specify an abbrevia- 
tion file for the SCALD directories you use during 
design sessions. This facility allows you to specify 
short names for SCALD directories when you enter 
the use command. A default abbreviation file, 
master.local, is placed in your directory when your 
account is created. You can add abbreviations to 
this file. 


If you specify a non-existent SCALD directory, a 
message is displayed, and the directory name speci- 
fied appears on the status line (it becomes the cur- 
rent SCALD directory). GED creates the actual 
SCALD directory when you write the drawing. 


When you include multiple use commands in your 
startup.ged file, you create a search stack of SCALD 
directories for GED. The order of the use com- 
mands in the file determines the order in which the 
SCALD directories are searched. The last SCALD 
directory listed in the file is the first SCALD direc- 
tory searched for the specified drawing; if the draw- 
ing is not found, the next directory is searched. 


You also put library commands in your startup.ged 
file to specify which component libraries you require 
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for your design. Libraries are searched according to 
the first library listed in the startup.ged file. Nor- 
mally, this is of little concern since the part names 
usually differ among libraries. An exception is the 
standard and ANSI versions of the same 54 or 74 
series library. (The same parts appear in both ver- 
sions; the body drawings are different.) 


Figure 2-3 shows a Startup.ged file and the search 
stack that those commands create. The file is as- 
sumed to be in the directory proj1. 


These GED commands... Create this Search Stack 


use proj2/proj2.wrk projl.wrk 


use projl.wrk proj2/proj2.wrk 
lib tutorial tutorial 
lib lsttl lsttl 


Figure 2-3. Search Stack Example 


This search stack allows you to access drawings 
stored in two SCALD directories, projl.wrk and 
proj2/proj2.wrk, and provides access to the 
TUTORIAL and LSTTL libraries. 


When you enter GED from your local project direc- 
tory ( proj1), the current, or active, SCALD directory 
is projl.wrk (the SCALD directory on the top of the 
stack). If an existing drawing to be edited is located 
in the proj2 directory, GED searches, in order, 
projl.wrk, and then proj2.wrk. 
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Borrowing a Drawing 
From Another User 
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If the specified drawing does not exist in any of the 
directories (including libraries) in the search stack, 
it is opened as a new drawing. When the new draw- 
ing is written, it is stored in projl.wrk. 


The use command can be used to add a new 
SCALD directory to the search stack. Each time 
you issue the use command, the newly-named 
SCALD directory is put on the top of the stack. The 
ignore command removes a SCALD directory from 
the search stack. 


If you specify a library name with the use com- 
mand, the associated SCALD directory is placed at 
the top of the active SCALD directory stack. 


By default, GED stores an existing drawing in the 
directory from where it was taken. The ignore com- 
mand allows a SCALD directory to be temporarily 
deleted in order to “borrow” a drawing from another 
SCALD directory. To copy a drawing from an- 
other SCALD directory, follow these steps: 


1 Go to the directory where the copy of the 
drawing is to be stored. 


2 Enter GED. Your current SCALD directory 


(for example, projl.wrk) is specified by your 
startup.ged file. 
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Enter the use command with the required 
file specification or abbreviation to change to 
the new SCALD directory, for example: 


use /u0/project2/project2.wrk 


or, if the abbreviation is set up in 
master.local: 


use project2 
Type: 
edit drawing name 
drawing name is the name of the drawing to 
copy. 
Type: 
ignore 


to delete project2.wrk from your active search 
path and to return to the initial SCALD direc- 
tory (projl.wrk). You are prompted to con- 
firm the operation. 


Type: 
y (yes) 


to confirm the ignore operation in response 
to the GED prompt. 


Type: 
write 


to store the drawing in your SCALD 
directory. 
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Before you write the drawing, you can enter the use 
command to specify a different SCALD directory. 
Alternately, you can specify a different SCALD di- 
rectory with the write command. Unless you have 
abbreviations set up in master.local, specify the path- 
name or file specification of the SCALD directory. 


write </julie/proj2/proj2.wrk> 
write <SCALD$ROOT: [TOM.PROJ2 ]PROJ2.WRK> 


Do not use the operating system command to copy a 
GED drawing. No entry would be made in the 
SCALD directory, and GED would be unable to find 
the drawing. 
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Drawing Names 


EXAMPLE § 


The drawing name is used to identify your designs. 
Whenever you create, edit, or process a drawing, 
you specify the drawing by its name. Several GED 
commands (such as edit, write, get, and add) allow 
or require you to enter a drawing (or component) 
name. 


Drawing names are made up of the following four 
fields: 


name.type.version.page 


subtractor.logic.1.1 


By default, if only a drawing name is entered 
(subtractor), GED assumes version 1 and page 
1 of a LOGIC drawing. 


To edit page 2 of the current drawing, type: 
edit ...2 | 


Table 2-1 illustrates GED naming conventions. 


You enter: GED assumes: 


write 32 bit alu 82 bit alu.logic.1.1 
edit nand. body nand.body.1.1 
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edit mux box...4 mux box. logic.1.4 


add nand 
add 1s00..2 


nand.body.1.1 
l1s00.body.1.2 


Table 2-1. Drawing Name Conventions 


The add command requires the specified drawing to 
be a BODY drawing. 
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Name Field 


Type Field 


You can change the default 
type with the push_type op- 
tion of the set command. 


See the ValidCOMPILER 
Reference Manual and the 
Library Reference Manual 
for more information on 
body types. 
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The first field of the drawing name is the user- 
defined identification of the drawing. In general, the 
name describes the intended function of the draw- 
ing. Some examples are: 


Ansi Disk Controller 
32-bit alu 

LS112 

10109 

HIGH-SPEED RAM 


The drawing name is not restricted to short alpha- 
betic identifiers or to uppercase letters. The name 
can be up to 255 characters long and can contain 
any printing ASCII character except the period (.), 
quotation mark ("), or tilde (-). Internal spaces 
are permitted. 


The second field of a drawing name identifies the 
particular type of drawing. If this field is not speci- 
fied, GED uses LOGIC as the default. Conse- 
quently, typing edit 32-bit alu has the same effect 
as typing edit 32-bit alu.logic. The add and 
replace commands assume BODY drawings. The 
get command assumes the type of the currently- 
edited drawing. 


The six standard drawing types are: LOGIC, BODY, 
TIME, SIM, PART, and PRIM. Generally, only the 
LOGIC and BODY types are used; the other drawing 
types are used for library development. 
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LOGIC 


BODY 


See Section 4, Design 
Techniques, for more in- 
formation on hierarchical 
drawings. 


Version Field 
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A LOGIC drawing is the standard type of drawing 
created with GED and is used to define a circuit 
made up of components (such as TTL or CMOS). 
Components are defined in the Valid libraries and 
additional components can be defined in user- 
created libraries. 


A LOGIC drawing can contain library parts (bodies) 
and hierarchical bodies that represent other logic 
drawings. A LOGIC drawing can only contain bod- 
ies defined in LOGIC directories. Bodies defined in 
TIME or SIM directories cannot be added to a 
LOGIC drawing. These parts are only used in li- 
brary development. 


A BODY drawing is the symbolic representation of a 
library part that you add to your design. This draw- 
ing defines the shape, pins, and general properties 
of the library part. 


When making a hierarchical design, you make a 
BODY drawing to represent an entire LOGIC draw- 
ing made up of library parts. This is called a 
hierarchical body. Using a hierarchical body allows 
you to refer to a collection of logic without having to 
include that logic in the drawing. 


The version field identifies different symbolic repre- 
sentations of body drawings. If the version is not 
specified, GED assumes version 1. 


The drawing version allows you to select different 
versions of a body. For example, an LSO00 NAND 
gate has two representations. One of the body draw- 
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ings is called LSOO.BODY.1.1, and the other is 
called LSO0.BODY.2.1, as shown in Figure 2-4. 


Figure 2-4. LS00 Body - Versions 1 and 2 


Refer to the SCALD 
Language Reference 
Manual for more infor- 
mation about using select 
expressions. 
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When you include the body with the add command, 
you can specify the version in the name of the body 
(add LSO00..2). Or, you can use the version com- 
mand to display different versions of a body. 


In addition to logical versions, a large number of 
library components have “sizeable” versions to sup- 
port the SCALD structured design methodology. 


Several versions of a drawing (for example, a timing 
model) can be created, with each version containing 
a different value or parameter. You can then use 
select expressions to specify a particular version for 
an application or process. 


The version field of the drawing name is NOT used 
to store revisions of a drawing. Use different draw- 
ing names to store various drawing revisions. 
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Page Field 
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The last field is used to create a drawing that ex- 
tends over more than one page. Paging is useful 
when the amount of logic required to define a par- 
ticular design does not fit on a single page. To be- 
gin working on the second page of the current draw- 
ing, type: 


edit ...2 


This tells GED to edit page 2 of the current drawing. 
The three dots hold the place of the first three 
fields, one for each field. The default value of 
“page” is 1. The number of drawing pages is 
unlimited. 
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Working With 
Drawings 


Specifying Drawings 
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This section describes basic drawing operations: 
e Bringing a drawing onto the screen 
e Saving a drawing 
e Renaming a drawing 
e Deleting a drawing 


The most common GED command used to specify a 
drawing is the edit command. After you enter GED, 
type edit and the name of the drawing you want to 
edit. If the drawing exists in the SCALD directories 
in the search stack, GED displays the drawing on the 
screen. If the drawing does not exist, GED displays 
a blank screen where you can begin your design. 
The name of the new drawing appears on the status 
line and is automatically added to the current 
SCALD directory when you write the drawing. 


You can edit a second drawing without writing the 
current drawing. The edit command saves the first 
drawing in a temporary file and then displays the 
new drawing. You can edit the first drawing again 
or you can use the return command to display the 
previously-edited drawing. The show history com- 
mand lists all of the drawings you edited during the 
current session. 


If you make changes to a drawing and then decide to 
go back to the original version of the drawing and 
start again, use the get command. This command 
replaces the drawing you are editing with the origi- 
nal drawing stored on the disk. Type get and the 
name of the drawing. 
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Saving a Drawing 


Renaming a Drawing 


Deleting a Drawing 
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To save your drawing on disk, use the write com- 
mand. You can specify the SCALD directory where 
the drawing is to be stored and the drawing name. 
If you are saving a newly-created design, GED 
stores the drawing in the current SCALD directory. 
GED stores a drawing you borrowed from another 
SCALD directory in the directory from which it was 
retrieved, unless you delete the SCALD directory 
from your search stack with the ignore command or 
specify another SCALD directory with the write 
command. 


The diagram command allows a copy of a drawing 
to be saved under a different name. You issue the 
diagram command from GED after you edit the re- 
quired drawing. When you write the drawing, a 
copy is saved under the new name. The original 
copy of the drawing is also saved. 


To delete a drawing, use the remove command. 
When you specify a drawing name with remove, 
GED displays the names of the associated drawing 
files. To proceed with the delete operation, type a 
semicolon (;) and press (Return). GED deletes the 
displayed files and the drawing directory and re- 
moves the drawing name entry from the SCALD 
directory. 


You can delete a specific page or version of a draw- 
ing or a specific drawing type by using the complete 
drawing name. 
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EXAMPLES § 
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remove ckt1.logic.1.2 


This command removes only page 2 of the drawing cktl. 


remove cktl1.body 


This command removes the BODY drawing for ckt1, but 
does not remove the LOGIC drawing. 


2-23 


The Editing Environment 


Creating a New Normally, you should create a subdirectory for each 


. ‘ design project rather than keeping all designs in your 
Pr oject Directory login directory. You copy the command and data 


files over to the new directory and set up a new 
SCALD directory file for the project drawings. 


To create a directory for a new project: 
1 Make sure you are in your login directory. 


2 Enter the appropriate operating system 
command to create the new directory. 


3 Copy the default files from your login direc- 
tory into the new directory. These files are: 


Use a wildcard character e All the command files (.cmd ) 
to copy all the .cmd files 
to the new directory. © startup.ged 

© case.dat 

e delay.dat 


4 Move to the new directory. 
Edit the startup.ged file: 


e Change the line use username.wrk to 
read use newdirectory.wrk (for example, 
use projl.wrk). Projl.wrk is now the 
name of the new SCALD directory for 
this project. 


e Add a library command for each required 
library (each library must be defined with 
a library command on a separate line). 
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The first time you save a 
drawing (using the write 
command), the SCALD di- 
rectory proj1.wrk is auto- 
matically created. 
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e Make sure that the masterlibrary com- 
mand indicates the correct path or file 
specification for the abbreviation file 
(master.local). 


e Save the new startup.ged file. 


6. Edit the compiler.cmd file (and the td.cmd 
file) and change the name of the SCALD di- 
rectory that appears in the DIRECTORY di- 
rective to the new name. For example, 
directory projl.wrk. 


Now you are ready to start a new project in the 
directory projl. To start working: 


1 Log in and move to your new directory. 


2 Type: 


ged 
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Creating a Design 


This section explains: 


Adding design elements to a drawing 
Defining groups 

Specifying drawing colors 
Duplicating objects 

Editing drawings and text 

Changing drawing views 

Checking drawings for errors 


Using GED scripts 
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GED provides a flexible and easy to use method for 
entering your designs. A convenient, on-screen 
menu displays the commands you use most often. 


Although there are few restrictions, the following 
rules ensure compatibility between your schematics 
and other SCALD design tools. 


«© ‘You cannot change the type of a drawing when 


you write the drawing. For example, if you 
are editing the drawing shifter.logic, you cannot 
save it as shifter.sim. You must use the 
diagram command to change the name and 
type of a drawing and then write the drawing. 


Bodies cannot be added into other BODY 
drawings and then saved. Although other bod- 
ies can be added to BODY drawings for com- 
parison purposes or as part of a new body, 
GED displays an error message if the BODY 
drawing is written out. In order to use another 
device as a base to work from, add the body to 
the BODY drawing and then use the smash 
command before you write the drawing. 


You cannot add incompatible bodies to draw- 
ings. For instance, simulator primitives are il- 
legal in TIME drawings. Both GED and the 
Compiler display error messages if you include 
illegal bodies in drawings. The directory com- 
mand displays information regarding the com- 
patibility of directories for the current drawing. 
You can add parts from any library, including 
SIM and TIME, to DOC drawings. 
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Adding Design All SCALD drawings are constructed from seven ob- 


Elements 


jects, or primitives: 


Bodies 

Wires 

Signal Names 
Dots 

Arcs 

Notes 
Properties 


Each of these items is added to a drawing by one or 
more vertices. 


The vertex is normally used to select an object. De- 
sign elements have the following vertices: 


Wires have a vertex at each end and at each 
bend. 


Bodies have a vertex to refer to the body it- 
self and a vertex for each pin. 


Text strings (signal names, notes, or proper- 
ties) have one vertex, located at the lower left 
corner of left-justified text strings (the de- 
fault), the lower right corner of right-justified 
text strings, and the center of center-—justified 
text strings. 


Circles and arcs have a vertex at the center of 
the circle. 


The show vertices command displays asterisks at 
all the vertices in the drawing. Figure 3-1 shows 
the vertices for each design element. - 
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“ Zt 
tay 


Body -— Vertices at Center and at Pins Wire - Vertices at Each End and Corner 


CLOCK Veen « — 


-: 
Lona 


Text - Vertices at Each Corner and Center | Dot - Vertex at Center 


Circle (360° arc) -— Vertex at Center Arc - Vertex at Center 


Figure 3-1. Design Element Vertices 
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Adding Bodies 


Refer to Section 4, Design 
Techniques, for informa- 
tion about using BODY 
drawings in hierarchical 
designs. 


Refer to the Library Reference 
Manual for more information 
on the Standard library. 


OPTIONAL: Before you 
set the body down, you 
can rotate it by pressing 
the white button. 
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A body is the symbolic representation of a drawing. 
The body drawing allows you to refer to a collection 
of logic without having to include that logic in your 
design. Generally, bodies are the components that 
are defined in the libraries you purchase with your 
Valid system software. You can also create bodies 
to represent repeated sections of a design or circuit. 


Before you can add a body to your drawing, you 
have to specify the required SCALD directory with 
the library or use command. Also, a Standard li- 
brary is automatically included with GED. This li- 
brary contains special bodies that you can use in 
your designs. 


To add a body to a drawing: 


1 Make sure that the proper library is accessed. 
You can issue the library command in GED 
or you can include the required library com- 
mand in your startup.ged file. 


2 Use the edit command to begin working on a 
schematic. 


3 Type: 
add bodyname 


Substitute the name of the required compo- 
nent for bodyname. This command attaches 
the specified body to the cursor. 


4 Press the yellow button to place the body on 
the drawing. To add another copy of the 
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Commands are active 
when they are high- 
lighted in a menu box. 


Body Versions 


Changing Pin States 
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same body, press the yellow button, move the 
cursor to the new location, and then press the 
button again. 


As long as the add command is active, you can add 
bodies to the drawing by typing the name of each 
body and pressing the yellow button to place it on 
the drawing. 


Also, add remembers the last body that was added 
to the drawing and attaches another copy of it to the 
cursor if you press any button before you enter a 
part name. The cursor must be in the drawing area. 


Many bodies in the Valid component libraries are 
represented by more than one version. Body ver- 
sions support different graphical, but functionally 
equivalent, representations of a part as well as vec- 
tored and non-vectored representations of sizeable 
parts. 


When you use the add command to specify the 
name of the body, GED assumes that you require 
version 1. You can specify the version with 
add bodyname..2, or you can use the version com- 
mand to cycle through all available versions of the 
body. To use the version command, select version, 
then point to the body and press the yellow button. 


The bubble command allows you to change the state 
of a pin from active high to active low. (The library 
part must be defined to support this feature.) Issue 
the bubble command, then point to the pin and 
press the yellow button. 
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Positioning Bodies 


mirror 


rotate 


spin 


Drawing Wires 
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GED also supports several commands that allow you 
to position and rotate bodies to meet your drawing 
requirements. 


Creates a mirror image of the selected body about 
the Y axis. 


Rotates a body 90° each time you press the button, 
with mirror images of the body at 180° and 270°. 


Rotates the body 90° each time you press the cursor 
button. 


The wire command is used to draw lines to connect 
the components of your schematic. This command 
is used with the buttons to begin, position, bend, and 
attach wires where required on the schematic. 


Yellow Cursor Controller Button 


Starts and attaches the wire at the nearest grid point. 
This button is also used to place additional bends in 
a wire. 


Blue Cursor Controller Button 


Starts and attaches the wire at the nearest appropri- 
ate vertex. The wire is not attached to vertices of 
text strings. 


White (Green) Cursor Controller Button 


Toggles between orthogonal and diagonal (direct) 
wire modes. 
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Press the yellow button twice to end a wire not at- 
tached to a pin or wire. Wires are automatically 
terminated at pins and wire junctions. 


Because schematics most often use orthogonal 
(bent) wires, GED uses orthogonal wires by default. 
Direct (diagonal) wires are also available. Press the 
white button to change the direction of the bend in 
the wire or to select the diagonal wire mode. You 
can also use the set command to change the wire 
mode. 


Figure 3-2 illustrates the most common wire shapes 
and the buttons used to draw them. 


The following conventions are used in the chart: 
e Button click points are shown as a filled dot. 


e Click all buttons once unless indicated other- 
wise by a (2). 


e All wiring shown is left-to-right. 
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ee ne eI es 


Yellow/Yellow (2) Yellow/Yellow/Yellow (2) 
i a 
Yellow/White/Yellow (2) Yellow/White (2)/Yellow (2) 
— 1. 
Blue/Yellow (2) Blue/Yellow/Yellow (2) 
oo he 
Blue/Blue Blue/Yellow/Biue 


Figure 3-2. Wiring Reference Chart 
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The Route Command 


You can use the route command to wire compo- 
nents together automatically. The route command 
connects two points by drawing a wire between 
them. If it cannot draw horizontal or vertical lines, 
it draws a diagonal line. route will not run a wire 
through any existing objects. 


The route command is simple to use. 


1 Enter the route command or select the route 
command from the menu. 


2 Select the first point. A flexible line is at- 
tached to the cursor. 


3 Attach the flexible line to the second point. 
route connects the two points with a wire. 


To select the nearest pin or wire vertex for a 
route point, use the blue button to select the 
point. Use any other button to select the 
nearest grid point. 
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Bus-through Pins 


Bus-through pins are special pins placed on a body 
to make it easier to wire a group of the bodies to- 
gether. For example, flip-flops are usually defined 
with a bus-through pin on the body exactly opposite 
the clock input pin. The clock signal can be con- 
nected to the clock input pin, and a second wire run 
from the clock bus-through pin to the clock input 
pin of the next flip-flop. Wiring with bus-through 
pins is shown in Figure 3-3. 


Figure 3-3. Wiring with Bus-through Pins 
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To connect a wire to a bus-through pin, use the wire 
command, position the cursor across from the input 
pin and press the blue button. The wire connects to 
the body. You can look at the drawing of the library 
part to determine if the part is defined with a bus- 
through pin. Use the edit command to display the 
BODY drawing of the part. 


You may use the show vectors command to display 
the pin names for the body. Bus-through pins have 
the same name as the corresponding real pin. The 
show pins command displays an asterisk on the 
side of the body where the extra pin is located. 


3-11 


Creating a Design 


Defining Signals and 
Connectivity 


Signal name 


Assertion level 


Signal bits 


Properties 


Refer to the SCALD 
Language Reference 
Manual for more infor- 
mation on signal syntax. 


You can identify each input signal of the circuit with 
a name. Signal names not only identify signals on 
the drawing, they allow you to enter other informa- 
tion that is interpreted by the SCALD design tools. 


The signal name is a string of characters that pro- 
vides a descriptive or mnemonic reference for the 
signal. All signals with the same name are inter- 
preted as the same signal. This is how signals are 
connected across pages of a multiple page drawing. 


The assertion level describes the active state of the 
signal when asserted. By convention, a signal is ac- 
tive high for positive logic and is active low for 
negative logic. Two signals with the same name but 
different assertion levels are NOT the same signal. 


Within the SCALD system, signals can represent a 
single bit (scalar signals) or multiple bits (vectored 
signals). The bit portion of the signal name speci- 
fies the number of bits (and which ones) the vec- 
tored signal represents. 


Signals can be given properties that describe charac- 
teristics of the signal, control how the signal is inter- 
preted by the Compiler, or convey physical 
information. 


The names you attach to the signals in the drawing 
are written into the connectivity file that GED creates 
when you save the drawing. A signal name is repre- 
sented in the GED database as a property named 
SIG_NAME with a value equal to the name of the 
signal. 
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Signame 


To name the signals on a schematic, you use the 
signame or busname command. These commands 
allow you to add names to the signals and buses in 
the drawing and associate each name with the re- 
quired signal. After signal names are placed on the 
drawing, the text strings can be moved without af- 
fecting their attachments to wires. 


The signame command allows you to type in sev- 
eral of the signal names for the drawing at one time. 
You then point to each wire in turn to attach the 
required signal name. As you place each signal 
name, the signal name is displayed attached to the 
nearest wire or pin, and the next one is displayed at 
the cursor. 


Alternately, you can first point to several wires with 
the cursor. An asterisk or cross marks each posi- 
tion. Next, type the signal names in order. The 
signal names are automatically placed at the indi- 
cated positions. 


For example, the following procedure can be used to 
name the primary input and output signals of the 
schematic shown in Figure 3-4. 


1 Select signame from the GED menu. 


2 Type: 


A (eu) 


The ‘A’ is attached to the cursor. 
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3 Type the following signal names. Be sure to 


press after each name: 


B 

C IN 
SUM 

C OUT 


4 Now move the cursor to the wire for signal A 
and click the yellow button once. The name 
appears near the wire. 


5 Next move the cursor to signal B and click 
the yellow button. 


Move to C IN and click. 
Move to SUM and click. 


Move to C OUT and click. 


oO ON O 


Select ; (semicolon) from the menu to end 
the signame command. 


Figure 3-4. Sample Schematic with Signal Names 
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Busname 


The busname command provides a convenient 
shorthand for naming signals in buses, or pins on 
bodies, whose names differ only in array subscripts. 
The name you specify is a simplified SCALD signal 
name such as: 


ADDRESS<7..0> 


GED reads the system-wide config.dat file to deter- 
mine the array subscript string, such as two dots 
(..) or a colon (:). Bus bit ordering can be 
MSB » LSB or LSB » MSB. Table 3-1 illustrates 
bus name syntax and the resulting signal names. 


Table 3-1. Bus Name Syntax 


- Bus Name Signal Name 


A<3>, A<2>, A<1>, A<0O> 


A<O>, A<1>, A<2>, A<3> 
A<0> 
A<7>, A<5>, A<3>, A<l1> 


If the array subscript character is a colon (:), the 
field separator becomes a double colon (::). For 
example: 


A<0:7::2> becomes A<0>, A<2>, A<4>, A<6> 


To use the busname command, enter the command 
with one of the following syntax options: 


e pt pt name 
e pt name pt 


e name pt pt 
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The name is a simplified SCALD signal name, such 
as A<0..3>. 


The two points specify the location of the first two 
names. The remaining names are placed automati- 
cally, with spacing between each name defined by 
the first two points. 


GED draws a bright line between the name and the 
wire to which the name is attached to verify that the 
signal names are attached correctly. 


For example, the following procedure can be used to 
name the primary input and output signals of the 
schematic shown in Figure 3-5. 


1 Type: 
busname DATA<7..0> 


GED attaches the string DATA<7> to the 
cursor. 


2 Place the name at the top wire and press the 
yellow button to enter the point. 


GED attaches the string DATA<6> to the 
cursor. 


3 Position the second name and press the 
yellow button. 


This name and the remaining signal names 
are placed on the drawing. 7 
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Bright lines are displayed so you can verify the accu- 
rate attachment of signal names to the drawing. 


OFF 
DATA<'?> 
DATA<6> D? 


e200000D00 1 
SOKeNWaAUDA 
ODODODODODO 
Senwaunn- 


Placing first signal name Placing remaining signal names 


Figure 3-5. Using Busname Syntax 


Adding Dots You can use the dot command to place dots on the 
drawing to clearly mark the connection of two wires. 


The system convention is that a T-junction is auto- 
matically a connection, whether or not it is dotted. 
A four-way intersection (+) is not a connection 
unless it is dotted. 


Dots are also used to represent connection points on 
BODY drawings. 


To use the dot command: 
1 Select dot from the menu. 


2 Move the cursor to the required wire junction 
and press the yellow button. A dot appears. 
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To automatically place dots on a complex circuit, 
you can use the following procedure with the 
auto dots command. 


Open dots are the default. 1 Type: 
If you want filled dots, 
first enter the command show connections 


set dots_filled. 
This command places asterisks temporarily 
on the drawing to highlight each connection 
point. 


2 Check the drawing to make sure that no con- 
nections have been made by mistake. 


3 Use the refresh command (window ;) to re- 
move the asterisks from the screen. 


4 Type: 


auto dots 


All the junctions are automatically dotted. 


You can automatically remove the dots from a draw- 
ing with the auto undot command. This command 
removes all the dots except those occurring at the 
intersections of four wires. 
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Using NOT Bodies 
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The NOT body in the Standard Library supports the 
Bubble Checker feature of the Compiler. The Bub- 
ble Checker verifies that signals and pins are con- 
nected only to other signals and pins having the 
same assertion. The Bubble Checker flags each sig- 
nal that is connected to another signal or pin of the 
Opposite assertion that does not have a matching 
NOT body. This allows you to catch errors when 
you intentionally connect a signal of one assertion to 
a pin of the opposite assertion. You add one of the 
four versions of the NOT body so that the bubble on 
the NOT body connects with the bubbled (low as- 
serted) signal or pin. 


To add a NOT body to a drawing: 


1 Type: 
cas 


2 Place the NOT body on the drawing. 


3 Use the version command to select the rep- 
resentation where the bubble on the NOT 
body faces the bubbled pin. 


4 Use the wire command to connect the parts. 


An example of using a NOT body is shown in 
Figure 3-6. 
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Figure 3-6. Using a NOT Body 


See the VALIDCompiler The NOT body is seen only by the Bubble Checker; 
aime Cate - it does not change the assertion of a signal. If the 
a cr aaa Bubble Checker is turned off (by a Compiler direc- 


tive), the signals on either side of the NOT body are 
joined together and the NOT body is ignored. 


Adding Properties A property is used to convey information about a de- 
sign. It consists of: 


e A capitalized name 
e A case-insensitive value 


Properties can be attached to bodies, signals (wires), 
signal names, and pins. Properties can also be at- 
tached to a drawing by attaching them to a special 
DEFINE or DRAWING body. 
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You can use the properties 
that have been developed 
for the SCALD system or 
you can define your own 
properties. Refer to the 
SCALD Language Reference 
Manual for more 
information about properties 
and property name syntax. 
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GED, in general, has no knowledge of rules about 
logic design or the ways in which components can 
be connected. GED does interpret the following 
properties: 


e LAST MODIFIED (on the DRAWING body) 


e PIN NAME (attached to connection points in 
BODY drawings. 


e SIG NAME 


e Properties added by the backannotate, 
section, and pinswap commands. 


e PATH (uniquely identifies parts) 


GED uses PIN NAME and SIG_NAME properties as 
part of its treatment of components. The informa- 
tion represented by the properties (except for back 
annotated properties) in a drawing is interpreted by 
the Compiler. This information is then passed to the 
other Valid design tools as well as to user—-developed 
programs. 


There are two ways of adding properties to a 
drawing: 


e Use the property command 
e Include a property in a signal name 


The meaning of the property is the same regardless 
of the method used. 
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Tips on Adding 
Properties 
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- Attach properties to bodies (or groups of bod- 


ies) with the property command. 


~ Signal properties are usually included in the 


signal name (Signame command), but can be 
added with the property command. 


~ Properties attached to pins are usually in- 


cluded in the pin name, but can be added 
with the property command. A pin property 
can also be inherited by a pin from a signal 
connected to the pin. 


To add a property to a drawing: 
1 Select property from the menu. 


2 Move the cursor to the object where the prop- 


erty is to be attached and press the yellow 
button. An asterisk appears on the selected 
object. 


Type the name of the property and the value 
of the property on the command line and 
press (Return). Leave a space between the 
property name and the value. The value ap- 
pears at the cursor. 


Alternately, you can separate the name and 
value with an equal sign (=) or by pressing 


between entries. 


Move the cursor to position the property and 
press the yellow button. 
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display name 
display value 


display both 


display invisible 
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By default, only the value is displayed when you add 
a property to a drawing. Use the set prop_display 
command to change the default display of proper- 
ties. The display command allows you to change 
the way a property is displayed. There are several 
display command options that affect properties: 


Display only the name of the property. 
Display only the value of the property (default). 


Display both the name and the value (separated 
by an equal sign) of the selected property. 


Display neither the name nor the value of the se- 
lected property. 


To change the display of a property: 


1 Type: 
display option 


Substitute the actual value for option. 


2 Point to each property to be changed and 
press the yellow button. 


For example, you can attach the property 
ABBREV=SBT to a drawing of a subtractor circuit 
and display the name and value by issuing the 
display both command. 
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show properties 


show attachments 


Drawing Arcs And 
Circles 


You can also use the circle 
command to draw arcs. 

See the circle command 
description in the ValidGED 
Command Reference 
Manual for procedures. 
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You can issue the show command to temporarily 
display information about the properties on the 
drawing. Two of the show command options are: 


Display both the name and the value of all the prop- 
erties (including signal names and invisible proper- 
ties) on the drawing. 


Display the connections between visible properties 
and the objects to which they are attached. 


You can add both arcs and circles to a GED draw- 
ing. This is most commonly used for BODY draw- 
ings, where circles represent bubbled pins. 


To draw a circle: 
1 Select circle from the menu. 


2 Select a point as the center of the circle and 
press the yellow button. 


3 Select a second point to determine the length 
of the radius and press the yellow button. A 
circle appears. 


To draw an arc: 


1 Enter the arc command and enter two points 
to indicate the ends of the arc. 
A circle is drawn with the two initial points 
indicating the end points of the arc. A 


flexible wire running between the _ initial 
points is attached to the cursor. 
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Adding Notes and 
Documentation 
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2 Position the arc as required and enter a third 
point to determine the curvature of the arc. 
The arc passes from the first point, through 
the third point, to the second point. 


e Press the yellow button to position the 
curve of the arc at the nearest screen 
pixel. 


e Press the white button to position the 
curve of the arc at the nearest grid inter- 
section. 


3 OPTIONAL: Select the semicolon (;) or the 
arc command instead of the third point to 
leave the circle on the drawing. 


You add annotations and comments to your drawing 
with the note and filenote commands. The infor- 
mation you place on the drawing with these com- 
mands is not interpreted by the Compiler or by the 
other Valid analysis programs. The note command 
is useful when you want to add a single line of text 
to the drawing. The filenote command allows you 
to place the entire contents of a specified text file on 
the drawing. 


Another way to add information about the drawing 
is to add a special body called the DRAWING body. 
The DRAWING body automatically displays the date 
and time when the drawing was last updated. You 
can also attach properties to the DRAWING body to 
add a title and abbreviation to the drawing. 
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A SIZE PAGE 


B SIZE PAGE 


The ABBREV property allows you to specify an ab- 
breviation for the drawing name. The SCALD sys- 
tem software requires an abbreviation for a drawing 
in order to identify each signal and library part. If 
you do not specify an abbreviation, the system auto- 
matically creates one. 


You can also attach the TITLE property to the 
DRAWING body to record the name of the drawing 
on the drawing itself. The drawing name on the 
status line does not appear on a printed copy of the 
drawing unless you add the TITLE property. The 
title you specify should exactly match the GED 
drawing name. | 


To add a border around your drawing, you can add 
a PAGE body. Page bodies vary in size, and may 
include company logos. Two types of PAGE bodies 
available in the Valid Standard Library: 


Places an A-size border (8 1/2 x 11 inches) around 
a drawing 


Places a B-size border (11 x 17 inches) around a 
drawing. 
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Defining Groups 


The Group 
Command 


The Select 
Command 
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GED provides several facilities for defining groups 
of objects. In GED, a group is made up of all verti- 
ces that are affected when the group is defined. 


For each defined group, GED assigns a letter of the 
alphabet as the name of each group and displays the 
name and the contents of the group on the screen. 
You can define up to 26 groups in each drawing. 
Alternately, you can assign a name to a group by 
entering a single letter after you issue the group or 
select command. Do not enclose the single-letter 
name in quotation marks. 


The group command allows you to draw a closed 
polygon around the required objects to identify a 
group. Use the yellow button to draw a line around 
the objects. Close the polygon by pressing the blue 
button when the cursor is near the starting point. In 
addition to drawing a polygon to group objects, you 
can simply press the blue button to include the near- 
est object in the same group. The option all places 
the entire drawing into a group. 


The select command provides a stretchable rectan- 
gle to define the boundaries of a group. Use the 
cursor and press the yellow button to position the 
rectangle around the objects to be included in the 
group. You can also press the blue button to include 
the nearest object in the same group. The all option 
places the entire drawing into a group. 
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The Find Command 


The Include 
Command 


The Exclude 
Command 
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The find command allows you to group all the oc- 
currences of a specified string or body. For exam- 
ple, find locates all the occurrences of a specified 
body name and places them into a group. You can 
then perform any group-manipulation commands 
(such as paint, replace, or version) on the group. 


The include command allows you to add objects to 
a defined group. Specify the initial group by enter- 
ing the group name on the same line as the include 
command; otherwise, the most recently created 
group is used. The starting group is highlighted. 
Press the yellow button to indicate objects to be in- 
cluded; press the white button to indicate groups to 
be included. 


Several optional arguments allow you to include 
types of objects in a group. The objects are included 
based on their association with objects already in the 
group. You can include bodies, connections, other 
groups, nets, properties, and wires. You can also 
include the owners of properties or signal names al- 
ready present in the group. 


The exclude command allows you to remove se- 
lected objects from a defined group. Specify the 
required group by entering the group name on the 
same line as the exclude command; otherwise, the 
most recently created group is used. The starting 
group is highlighted. Press the yellow button to indi- 
cate objects to be removed; press the white button to 
indicate groups to be removed. 


1/15/89 


1/15/89 


Creating a Design 


Several optional arguments allow you to exclude 
types of objects from a group. You can exclude bod- 
ies, connections, other groups, nets, properties, or 
wires. You can also exclude the owners of proper- 
ties or signal names in the group. 


After the group is defined you can use the copy, 
cut, paste, delete, change, smash, display, 
move, paint, replace, and version commands to 
manipulate the group. To perform an editing opera- 
tion on a group, select the group by typing the group 
name or by pressing the white or green button when 
the cursor is near the group. 
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Using Color 
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The paint command allows you to specify the colors 
of the objects and groups in your drawing. Even if 
you are working on a monochrome monitor, you can 
add color to drawings that can be printed on a color 
plotter or transferred to a color workstation. 


You can use up to 16 colors in your designs. They 
are preset colors and cannot be changed: 


Red Orange Salmon Aqua 
Green Purple Violet Peach 
Blue Gray Skyblue Brown 
Yellow White Pink Mono 


You can assign a color to a defined group by includ- 
ing the color name and group name on the paint 
command line or by entering the paint command, 
selecting the color from the menu, and entering a 
single-letter group name. 


There is also a default option to the paint com- 
mand. This paints objects in their preset default 
colors. Use the set command to establish default 
colors for the objects in your drawings. 


If you have a color monitor, the objects are drawn in 
the actual colors you specify. If you use a mono- 
chrome monitor, you can use the show color com- 
mand to display the names of the colors assigned to 
the objects in your drawing. 


The window and zoom commands can be nested 
within the paint command. 
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When you issue the paint command, the status line 
is replaced by a list of the available colors. To as- 
sign a color to an object: 


1 Issue the paint command. 


2 Use the cursor to select a color from the 
paint menu. 


3 Point to the object and press the yellow 
button. 
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Making You can copy bodies, wires, properties, and groups 
. in a drawing. This feature allows you to work more 
Duplicates quickly and efficiently. By positioning copies of 
wires, you can achieve consistency and uniformity in 

a drawing. 


To copy an object in the drawing: 
1 Select copy from the menu. 


2 Move the cursor to the object to be copied 
and press the appropriate button. 


e The yellow button picks up a copy of the 
object at the grid point nearest the cur- 
sor. 


e The blue button picks up a copy of the 
object at the vertex nearest the cursor. 
(Useful for copying bodies.) 


3 Move the copy to its required location and 
press the appropriate button. 


e The yellow button places the copy on the 
grid point nearest the cursor. 


e The blue button attaches the copy to the 
vertex nearest the cursor. This is useful 
for attaching copies of wires at new 
locations. 
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To make a copy of a group, use the white or green 
button to pick up the group of objects nearest the 
cursor. Alternately, specify the name of the group 
when you issue the copy command. Position the 
copy and then press the yellow button to place the 
copy down on the drawing. 


The copy command also accepts an argument to 
specify the number of copies to be made. After the 
first copy is placed, the remaining copies are auto- 
matically added to the drawing. The second copy is 
offset from the first copy by the same distance as 
the first copy from the original. You can use this 
feature to copy single items and groups. Use the 
following procedure: 


1 Issue the copy command and enter a number 
to specify the number of copies to be made. 


2 Move the cursor to the object or group to be 
copied and press the appropriate button 
(yellow for objects, white for groups). 


3 Move the copy to its location and press the 
appropriate button (yellow to place the copy 
on the nearest grid point, blue to attach the 
copy to the nearest vertex). 


Figure 3-7 shows how this command can be used to 
attach wires to an 8-MERGE body. 
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Wire the first connection. 
Enter the command copy 7. 


Move the copy to the first wire and 
press the yellow button. 

Position the cursor at the next pin 
and press the yellow button. 


The remaining six wires are placed on 
the drawing. 


Figure 3-7. Making Multiple Copies 


You can also make copies of most properties on the 
drawing. Default properties and user-added body 
properties are automatically included in copies made 
of bodies. However, pin properties, such as pin 
numbers, are not copied. Wire properties are not 
automatically included when you copy a wire. Un- 
named signals and PATH properties are not copied, 
since GED creates them automatically. 


You cannot copy default body properties, pin prop- 
erties, and those properties generated by the 
section, pinswap, and backannotate commands. 
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When you copy a property, the copy command lets 
you attach the property to its new location: 


1 Select copy from the menu. 


2 Move the cursor to the property to be copied 
and press the yellow button. 


3 Use the cursor to position the copy and press 
the yellow button to position the property on 
the drawing. A flexible line is drawn from 
the property to the cursor. 


4 Move the cursor to the object where the prop- 
erty is to be attached and press the yellow 
button. 


To copy objects or groups from one drawing to an- 
other drawing, use the cut and paste commands. 


The cut command places the specified object or 
group in a buffer. Default body properties and 
user-added body properties are included in copies 
made of bodies. Path properties, pin properties, and 
the properties generated by the pinswap, section, 
and backannotate commands are not included in 
the cut buffer. Wire properties are copied when a 
wire is cut. This allows you to transfer signal names 
to the new drawing. 
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To add the contents of the cut buffer to a new draw- 
ing: 


1 Edit the new drawing. 


2 Issue the paste command. A copy of the cut ' 
buffer is attached to the cursor. 


3 Use the cursor to select the point for the cop- 
ied material and press the yellow button. 
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Making Changes 


Changing Default 
Values 
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GED provides a full range of editing functions that 
allow you to correct, modify, and fine tune your 
design. 


While you work on a design, GED maintains an 
undo and redo log that records the changes you 
make to the current drawing. If you change your 
mind about a particular change or a series of 
changes, you can use the undo command to step 
back through your work. Using the undo command, 
you can back up to the last edit or write command. 
The undo command does not undo screen opera- 
tions and is reset when you edit another drawing. 


The redo command allows you to redo an undo op- 
eration if you back up too far with the undo 
command. 


Many GED commands have pre-established default 
values that you can use to create your designs. For 
example, the dot command draws open dots, and 
the wire command uses orthogonal wires. The set 
command is issued during an editing session to 
change a command’s default behavior, while the 
display command is used to change the drawing. 
Additionally, the set command can be placed in 
your startup.ged file. Both commands have many 
options to allow you to tailor GED to your particular 
preferences and requirements. 
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Refer to the discussion of 
the display command in 
the ValidGED Command 
Reference Manual for 
more information. 


Refer to the discussion of the 
set command in the ValidGED 
Command Reference Manual 
for details. 
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The display command is used to change the way 
particular objects appear on the drawing. You spec- 
ify the object or group to be changed. Once you 
modify the drawing with the display command, the 
change stays in effect. (The show command has 
only temporary effects on the drawing.) 


The set command allows you to change the default 
behavior of many GED commands. If you issue the 
set command during an editing session, you change 
the value for that entire session. For example, to 
increase the default size of text, issue the set size 
command and specify the size to be used. 


You can also place set commands in your 
startup.ged file to establish your own default values. 
For example, if you always use filled dots on your 
drawings, enter the command set dots filled into 
the startup.ged file. Or, if you prefer to draw with 
the grid displayed, enter the command set grid_on 
into the startup.ged file. 


set commands can also be placed in the system- 
wide startup.ged file to establish system-wide default 
values. 
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Editing Text on a 
Drawing 
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You can use the change command to edit the text 
on your drawing. This command allows you to 
change property names and values, signal names, 
and notes. You can use the GED line editor or you 
can place the text into a file and then use the system 
text editor to make changes. 


GED observes some rules about performing opera- 
tions on properties. For instance, default body 
properties cannot be deleted and their names cannot 
be changed (although “soft” properties can be 
changed). GED gives an error message if an illegal 
operation is attempted. 


To use the line editor: 
1 Select change from the menu. 


2 Point to each text string to be changed and 
press the yellow cursor button. You can also 
define groups of text strings and then select 
the group with the white button or by entering 
the group name before you select more 
strings. 


The text string being edited is displayed on 
the status line. 


3 Use the line editing functions to modify the 
text (see Table 3-2). When you make a 
change and then press (Return), the text 
string is repositioned on the drawing and the 
next string is displayed on the edit line for 
modification. 
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Table 3-2. Line Editor Functions 


Moves the cursor forward one character. 
Moves the cursor backward one character. 
Moves the cursor to the end of the line. 


Moves the cursor to the beginning of the line. 


Deletes one character to the left of the cursor. 
Deletes one character to the right of the cursor. 
Deletes the remainder of the line (right of the 
cursor). 


Displays the help file for the line editor. 


Keys 


ne 


| 
A 


Repositions the text currently on the edit line and 
displays the next line of text to be edited. When 
all text has been edited, exits the line editor. 


Searches to the right of the cursor for the 
-S character specified character. 


(Controd)-R harceiee Searches to the left of the cursor for the specified 


character. 
(Controd)-U number 
command 


alg 


Repeats the command the specified number of 
times. If no number is given, the default is four. 


Aborts changes to the text currently on the edit 
line. 
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UNIX systems use the vi 
editor; VMS systems use 
the EDT editor. 


You can change the default 
system editor with the 
set user_editor command. 


Searching For 
Patterns 
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To use the system text editor: 


1 Enter the change command. 


2 Select the text strings with the cursor. 


3 Press ((Contro)|-V. This accesses the system 
editor. 


A file containing the text strings you selected 
is displayed. Edit the file to make the re- 
quired changes. Be sure not to add or delete 
any lines in the file. Refer to the appropriate 
manual for information about using the editor 
on your system. When you end the editing 
session, the drawing is redisplayed with the 
modified text. 


The find and next commands allow you to locate all 
occurrences of a specified text string. This can help 
speed up the process of editing similar text strings 
such as property names and values, notes, and sig- 
nal names on the drawing. 


The find command places all the occurrences of ob- 
jects matching the pattern into a group. GED labels 
the group and lists the number of drawing elements 
it contains. The next command displays an asterisk 
at each item so it can be changed or deleted. If 
necessary, items are also centered on the screen. 
Because all the items are placed in a group, you can 
perform an operation such as replace, version, 
change, display, or delete on that group to make a 
global change to the drawing. 
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To specify a search pattern: 


1 Type: 
find pattern 


The find command is not case-sensitive; it 
does not distinguish between uppercase and 
lowercase letters. You can use wildcard 
characters in the pattern. An asterisk (*) 
matches anything, and a question mark (?) 
matches any single character. An equal sign 
(=) implies a search for properties; separate 
patterns for the name and value are accepted. 


2 Type: 
next 


The first occurrence of the pattern is dis- 
played in the center of the screen. You can 
change the item or type next to display the 
next occurrence of the pattern. 


Moving Objects There are several commands that let you move and 
| manipulate the objects on your drawing. You can 
choose move, split, swap, reattach, or pinswap, 

depending on the particular application. 


The Move Command The move command allows you to reposition objects 
on the drawing. When you move an object or a 
group, all the connections and attachments on the 
drawing are maintained. This is a special feature of 
GED called dynamic dragging. 
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The move command also operates on defined 
groups of objects. Properties are moved with the 
Objects to which they are attached, or they can be 
moved independently. 


To use the move command: 


1 Select move from the menu. 


2 Position the cursor at the object to be moved 
and press the appropriate button. 


The yellow button picks up the object at 
the grid point nearest the cursor. 


The blue button picks up the object at the 
nearest vertex. (Useful for copying 
bodies.) 


The white or green buttons pick up 
groups. Alternately, you can specify the 
group name when you _ issue the 
command. 


3 Move the object to its new location and press 
the appropriate cursor button. 
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The yellow button places the object on 
the grid point nearest the cursor. 


The blue button attaches the object to the 
nearest vertex. 
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The Split Command Occasionally, items and wires become placed on top 
of each other when you are working on a design. 
The split command is useful for separating objects. 
You can also use the split command to disconnect a 
wire from one pin and move it to another pin. 


To use the split command: 
1 Select split from the menu. 


2 Point to the objects and press the blue button. 


One of the objects is attached to the cursor so 
it can be moved about on the screen. To 
move one of the other objects, point to the 
objects and press the blue button again. You 
can continue to select objects at that vertex 
until the correct object is selected. 


3 Reposition the object and place it down by 
pressing the appropriate cursor button. 


You can also use the split command to add more 
wire segments to an existing wire. This is useful for 
creating orthogonal wires from diagonal wires. 


1 Select split and identify a point along the 
wire using the yellow button. This adds a 
vertex at the specified point. 


2 Move the vertex to its new location and press 
the yellow button. 


3 Use the wire command to add a new section 
of wire. 
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The Reattach Command | The reattach command reattaches properties (in- 
cluding signal names) from one object to another. 


To use the reattach command: 


1 Type: 


reattach 


2 Select the property to be reattached. A line 
is drawn from the property to the current cur- 
sor position. 


3 Specify the object that is the new attachment 
point for the property. 


4 If necessary, use the move command to relo- 
cate the property closer to its new attachment 
point. 


Default body properties and those produced by the 
backannotate, pinswap, and section commands 
cannot be reattached. 


The Swap Command Use the swap command to interchange the positions 
of two properties or two notes. Only two properties 
or two notes can be exchanged, not a note and a 
property. 


To use the swap command: 
1 Enter the swap command. 


2 Point to the two notes or the two properties to 
be exchanged; press the yellow or blue button 
each time. 
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Deleting Objects 
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The pinswap command works just like the swap 
command. It is used to exchange the pin numbers 
assigned to a body by the section command. 


The delete command removes unwanted objects 
and text from the drawing. You can also use the 
delete command to delete specified groups of 
objects. 


To use the delete command: 
1 Select delete from the menu. 


2 Point to the object to be deleted and press the 
yellow button. The object nearest the cursor 
is deleted. 


Alternately, you can specify the group name or 
press the white or green button to delete a group. 


You cannot delete default body properties or pin 
number properties generated by the pinswap 
command. 
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Viewing the 
Drawing 


Panning 
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GED manages drawings that can be as large as 
64 inches on each side if plotted in a single drawing 
page. When this much area is displayed on the 
screen, the objects on the drawing are so small that 
they are too difficult to manipulate. GED lets you 
view the large drawing area through a window. By 
positioning the window and changing the scale at 
which images are viewed, you can display anything 
from a very small portion of a drawing to the entire 
drawing on the screen display. 


GED provides window and zoom commands to let 
you zoom in on part of a drawing, zoom out, pan to 
different areas, and center the screen around a 
specified point. You can also reduce and enlarge 
selected portions of the drawing or the entire draw- 
ing. Changing the view of the drawing on the screen 
does not affect the actual size of the drawing; it al- 
lows you to pan and zoom for visual convenience. 


Panning refers to the process of moving the window 
to view different portions of the drawing without 
changing the scale. To do this, you issue the zoom 
or window command and then either specify a point 
to be used as the new center of the viewing area, or 
you type in one of the zoom or window command 
options that specifies a panning direction: left, 
right, up, or down. The drawing remains at the 
current size, but you see a different view of it. 
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To pan a drawing using a specified point: 


1 Enter the zoom command. 


2 Move the cursor to the point on the screen to 
be centered and press the blue button. 


You can also specify a panning point with the 
window command: 


1 Select window from the menu. 


2 Move the cursor to the place on the drawing 
to be centered on the screen. 


3 Press the yellow button. An asterisk appears 
on the screen. 


4 Select the semicolon (;) from the menu or 
type: 


; 


The part of the drawing where you placed the 
asterisk moves to the center of your screen 
and the asterisk disappears. The scale of the 
drawing does not change. 


zooming Zooming in is the process of enlarging a portion of 
the circuitry to let you see more detail. It is espe- 
cially useful for checking the wiring and connections 
on large drawings. You can use either the zoom or 
the window command to zoom in on part of the 
drawing. 
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The zoom command allows you to specify a rectan- 
gle defining an area of the drawing to be enlarged. 
To zoom in on a portion of the drawing: 


1 
2 


Issue the ZOOM command. 


Press the yellow button to indicate one corner 
of the rectangle. 


Move the cursor to the opposite corner and 
press the yellow button. 


The area of the drawing defined by the rec- 
tangle is enlarged to fill the screen. You can 
draw additional rectangles to further zoom in 
on the design. 


To use the window command to enlarge a portion of 
the drawing, follow these steps: 


1 
2 
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Select window from the menu. 


Move the cursor to one corner of the area you 
want to enlarge and press any button. 


Move the cursor diagonally to the opposite 
corner of the area you want to enlarge and 
press the yellow button. 


Select the semicolon (;) from the menu, or 
type: 


3 


The selected area enlarges to fill the entire 
screen. 
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Refer to Figure 3-8. 
This first point is la- 
beled C (for center). 


The second point is la- 


beled “2” in the figure. 


This third point is la- 


beled “3” in the figure. 


You can issue additional window commands to fur- 
ther zoom in on the design. Another version of the 
window command allows you to zoom in and center 
the display simultaneously. 


1 Select window from the menu. 


2 Move the cursor to the place on the drawing 
to be centered on the screen and press any 
button. An asterisk appears on the screen. 


3 Move the cursor to the right an inch (or so) 
and press any button. A second asterisk 
appears. 


4 Move the cursor to the right for an equal dis- 
tance (about an inch) and press any button. 


CLOCK ENABLE 
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Figure 3-8. Zooming In and Enlarging 


Because the distance between point C and point 3 is 
larger than the distance between point C and point 
2, the drawing is enlarged. The enlargement factor 
is based on the ratio C-3 to C-2. If the distance 
between point C and point 3 is twice as far as the 
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distance between point C and point 2, the drawing 
size is doubled. You can vary the enlargement fac- 
tor by changing this ratio. 


You can also use this form of the window command 
to zoom out or reduce the screen size of the selected 
portion of the drawing. 


1 Select the window command from the menu. 


Refer to Figure 3-9. 2 Move the cursor to the place on the drawing 
The first point is labeled 


C (for center) to be centered on the screen and press any 
button. An asterisk appears on the screen. 


The second point is la- 3 Move the cursor to the right an inch (or so) 
led “2” in th . : 1 
bele NE Jigure and press any button. A second asterisk 
appears. 

This third point is la- 4 Move the cursor back to the left to a point 


b l “ay 3 th , ‘ . : 
hed od Ue Gane about halfway between points 1 and 2 and 


press any button. 


CLOCK ENABLE 


Figure 3-9. Zooming Out and Reducing 


Because the distance between point C and point 3 is 
less than the distance between point C and point 2, 
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the drawing is reduced. The reduction factor is 
based on the ratio C-3 to C-2. If the distance be- 
tween point C and point 3 is half as far as the dis- 
tance between point C and point 2, the drawing size 
is reduced by half. You can vary the reduction fac- 
tor by changing this ratio. 


When you zoom out of the drawing, text that be- 
comes too small to read is replaced by rectangles. 
The rectangles remind you that there is text at the 
indicated positions. If you zoom out far enough (de- 
pending on your workstation), the rectangles them- 
selves may disappear entirely when the text is too 
small to be seen. When you enlarge the drawing, 
the actual text is redisplayed. 


To use the Zoom command to zoom out and reduce 
the drawing: 


1 Issue the zoom command. 


2 Press the yellow button to indicate one corner 
of the rectangle. 


3 Move the cursor to the opposite corner and 
press the white button. 


The screen shows arrows pointing from the 
corners of the screen image to the corners of 
a rectangle into which the current screen is 
compressed. 


The graphics in the drawing area are shrunk 
down to fit into the sizeable box. 
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Scaling the Drawing 


zoom -2 
window 2 
zoom 1.5 


window 0.5 
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The size of this rectangle relative to the size 
of the GED window represents the amount of 
reduction used to display the design. 


4 Press the yellow button. 


The area of the drawing displayed on the 
screen is reduced to fit into the rectangle. 


You can use the window or zoom command to 
change the displayed size of the entire drawing. 


Specify an integer or a real number to scale the view 
of the drawing by the entered amount. The center 
of the window remains the same. 


For example: 

Makes the drawing appear half as large. 
Makes the drawing appear twice as large. 
Enlarges the drawing one and a half times. 
Has the same effect as zoom -2. 


The minus sign (-) in front of the scale factor scales 
the drawing by the inverse of the specified scale 
factor. 
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Viewing the Entire You can view the entire drawing with the fit option 

Drawing to the window and zoom commands. This option 
scales the drawing to fit into the window area, pro- 
viding you with a global picture of your design. 


To fit the entire drawing into the window, type: 


window fit 


or 


zoom fit 


The drawing is enlarged or reduced to fit entirely on 
the screen. 
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Checking For After you complete a drawing, you can use the 
check and error commands to locate connectivity 
Errors problems and other general errors. These problems 


are difficult to detect visually and can cause compi- 
lation errors. 


The check command assigns the path property to 
all the parts in the drawing and examines the draw- 
ing for these errors: 


e Pins attached to more than two wire segments 
e Duplicate components in the same location 


e Wires connected to only one pin and not named 
(NC wires) 


e Nets that are named but not connected to any 
pins 

e Wires that come close to but do not contact pins 

e Duplicate PATH properties 

e Unmarked wire connections 

e Wires overlapping a body 

e Missing TITLE and/or ABBREV properties 

e Bodies that are placeholders 


e Pins located at the origin (0,0) in BODY 
drawings 


e Multiple dots at the same location 
e Hard properties with the ? value (placeholders) 


e Objects partially outside the GED drawing 
boundaries 


e Wires connecting the pins of a two-pin body. 
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The check command lists each detected error. Af- 
ter you run the check command, you use the error 
command to locate each error on the drawing. 


The error command steps through the errors located 
by check, draws an asterisk at the location of the 
error, and displays a message describing the error. 
To use these commands: 


1 Type: 


check 


check processes the drawing and displays the 
results in the upper left corner of the screen. 


2 Type: 


error draws an asterisk at the first error and 
displays an error message. You can edit the 
drawing to fix the problem. 


3 Issue the error command again to display the 
next error located by check. You can step 
through each error to fix all the problems de- 
tected by the check command. 


The set check_on_write feature automatically initi- 
ates the check command every time you write a 
drawing. To toggle this feature off, enter: 


set check_on_write off 


This command can be placed in your startup.ged file 
or issued during the editing session. 
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GED’s script command allows you to create a file 
containing a list of GED commands (a script ) and 
execute that list of commands in GED. This allows 
you to operate in batch mode using the same syntax 
as if you typed in the command. 


Scripts can call other scripts; in fact, this is done in 
the standard initialization script startup.ged. Scripts 
can also be interactive. You can use the cursor to 
enter points, you can specify the X-Y coordinates in 
the script file, or you can include user input tokens to 
allow a script to request user input during operation. 


User input tokens must be placed at the beginning 
of a new line. There are two user input tokens. 


When GED encounters this token in a script, it 
prints from the token to the end of the text line as a 
prompt, then waits for one item of input. The input 
can be a typed line, a function key press, a cursor 


controller point, or a (Contro))-C; you cannot use a 


as a response to a user input request. 


This token also prints from the token to the end of 
the text line as a prompt and awaits input, but this 
token accepts and interprets input until you enter a 
semicolon. If this token is included, GED follows 
the prompt with the message: 


Type ; when done with user input. 


When GED sees a user input token in a script, it 
highlights a menu button with the name of the GED 
command being executed. 
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Some simple script examples are shown below. 


add 1s04 
$<Place the LS04 


EXAMPLES { 


Add an LS04 to a drawing and use the mouse to position the 
part. 


property 

$<Choose the part to add a size to 
size = 

$<Type in the size you want 

$<Place the property on the drawing 


Add a size property to a part with a size specified at the time 
of entry. 
rotate 
$;Rotate the object until properly oriented 
Rotate an object until the user enters a semicolon. 

A more complicated script might contain a large 


number of signame commands and prompt the user 
for a point to place each SIG_NAME property. 
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This section introduces: 


e Flat design techniques 
e Structured design techniques 


e Hierarchical design techniques 
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Flat Designs 


Structured Designs 


Hierarchical Designs 


Depending on your particular requirements, one of 
these three techniques can best meet your needs: 


A flat design is an efficient method for creating a 
design that is small and does not re-use portions of 
the circuitry. Flat designs are required for complete 
backannotation of the design and are more conven- 
ient for troubleshooting. Flat designs can include 
multiple drawing pages. 


Structured designs allow abbreviated bus structures 
and minimize the required number of parts and in- 
terconnections. Structured design techniques using 
the SIZE property support designs that use large 
bused signals, register depth, and memory depth. 


Hierarchical designs use symbolic representations of 
circuitry for functions that are repeated throughout a 
design. Large designs that can be broken into func- 
tional modules or designs that re-use portions of cir- 
cuitry can be efficiently created with the hierarchical 
technique. 


Although all designs can be entered as flat draw- 
ings, choose the method most appropriate to your 
particular design. SCALD tools are specially de- 
signed to operate efficiently with structured and hi- 
erarchical techniques. 


Additionally, the optional schematic flattener, 
ValidFLAT/Transcribe™, allows you to use struc- 
tured or hierarchical design techniques and produce 
a conventional, flat drawing. This tool transforms a 
structured or hierarchical design into a flat drawing 
that shows every pin and part explicitly. 
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Design Techniques 


Flat Designs 


Creating a Flat 
Design 
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The flat drawing method is the most straightforward 
technique for creating a design on the Valid system. 
In a flat design, all parts on the drawing come from 
Valid or user-defined libraries and are one-to-one 
logical representations of the physical parts. All of 
the interconnecting wiring within the design is en- 
tered pin-to-pin. 


Flat designs are best suited for small designs that do 
not have sophisticated bus requirements or re-use 
portions of circuitry. Also, if the design must be 
completely backannotated with pin and physical lo- 
cation numbers, a flat drawing is required. 


Both single-page and multiple-page flat drawings 
can be created with GED and processed by the Valid 
design analysis programs. 


LARGE DESIGN.LOGIC.1.3 


LARGE DESIGN.LOGIC.1.2 
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Figure 4-1. Single and Multiple Drawing Pages 


Some designs are small enough to fit on one page of 
a drawing. 


Design Techniques 


To create a single-page design: 


1 


Specify the drawing name with the edit 
command. 


Use GED to draw the design on the screen. 


Use the write command to store the design 
on the disk. 


Use the other SCALD analysis programs to 
compile, simulate, verify, and package the 
design. 


If the drawing is too large to fit on one page, use the 
following procedure to create a multiple—page 
drawing. 


1 Specify the drawing name with the edit com- 


mand and create page 1 of the design. 
Use the write command to save page 1. 


Type: 
edit ...2 
to begin page 2 of the drawing. 


This command uses the current drawing 
name, the default drawing type, and the cur- 
rent version. The default drawing type 
(initially LOGIC) is changed with the 
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Benefits of Flat 
Designs 
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set push_type command. If necessary, en- 
ter the drawing type and version to specify 
the correct drawing name. 


4 Use the write command to save page 2. 


5 Create subsequent pages of the drawing in 
the same way (edit ...8, edit ...4). 


All pages of a multi-page design have the same 
drawing name. The Compiler links all drawings 
with the same name. If the names are different, 
each page is treated as a separate drawing. 


Give signals that cross page boundaries the same 
signal name on subsequent pages. Signals with the 
same name have an implicit connection, even if they 
appear on different pages. For example, the signal 
SYSTEM CLK on pages 1 and 3 has the same effect 
as being on the same page with both instances wired 
together. 


Using a flat design technique has these advantages: 


e This technique requires a minimum learning 
curve and there are few rules”. and 
restrictions. 


e Since every part and signal are explicitly 
shown on a flat drawing, pin numbers and 
physical location designators can be fed back 
from a physical design system and backan- 
notated onto the schematic. This produces 
flat print sets with all physical information 
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documented. This is useful for design trou- 
bleshooting and is sometimes required by 
company standards. 


Considerations of Keep these considerations in mind when you create 
Flat Designs a flat drawing: 


e Flat designs take longer to create and process 
than structured and hierarchical designs. 


e Flat designs tend to be cluttered and hard to 
read unless special care is taken to organize 
and layout the design. 


e Troubleshooting Compiler errors in a large, 
multi-page flat design is time consuming and 
difficult. 
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Structured 
Designs 


Creating a 
Structured Design 


SIZE Property 


The structured design method facilitates the entry 
and analysis of sophisticated designs that make use 
of bused signals and memory and register depth. A 
structured design minimizes the number of intercon- 
nections and parts on the schematic. 


You use GED commands to enter and store your 
drawing. The main difference between a structured 
design and a flat design is the use of special library 
parts and the SIZE and TIMES properties. 


The SIZE property is attached to a body and is used 
to specify the width of pin names, signal names, and 
to define size expansion. 


For example, there are two versions of an LS374 
octal register in the LSTTL library. Version 1 is a 
one-bit slice of the part. It accepts a one-bit D 
input and produces a one-bit Q output. Version 2 is 
the full chip representation of the LS374 with all 
eight input and output bits explicitly shown. The 
two LS374 versions are shown in Figure 4-2. 


Figure 4-2. LS374 Body — Versions 1 and 2 
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Version 1 is sizeable; that is, you can specify the 
number of bits the part can represent. Library parts 
are generally developed with version 1 sizeable. 
The show vectors command displays the pin 
names of a selected part, allowing you to verify that 
a part is sizeable. 


You attach the SIZE property to version 1 of the 
LS374 part to define the number of bits pins D and 


See the SCALD Language Q represent. Valid’s signal syntax for bus notation 
Reference Manual for is used to specify a range of bits for the input and 
more information about output signals. 


signal syntax. 


Figure 4-3 illustrates how you can use version 1 of 
the LS374 part in a structured design. In this exam- 
ple, the number of bits is set to 8 (SIZE = 8B); any 
number of bits can be specified to meet your 
requirements. 


SIZE=8B 


OUT A <7. .@> 


Figure 4-3. Using the SIZE Property to Structure LS374 
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Version 2 of LS374 (see Figure 4-4) is the flat rep- 
resentation of the part. Each pin on the drawing 
represents a pin in the physical package. 


HHA HHHHHH 
LLLLELL LL 


Figure 4-4. Using Version 2 of LS374 


Figure 4-5 illustrates the difference between using 
structured and flat design techniques. Using the 
SIZE property can greatly minimize the number of 
parts and interconnections. Also, many possible en- 
try errors are avoided. 
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BUS<31. .@> 


Figure 4-5. Structured and Flat Design Techniques 
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TIMES Property The TIMES property is used with the SIZE property 
on structured designs. TIMES allows you to create 
your structured design to databook specifications. 
TIMES can be used in cases where the SIZE prop- 
erty causes loading errors. For example, in 
Figure 4-6, a single part is driving too many inputs 
on SIZE-replicated parts. 


SIZE=32B 


MEMORY 
DATA IN<K31..@> DATA OUT1<31.. > 


ADDRESS<3. . @> 


DATA OUT2<31.. 


SIZE=4B 


Figure 4-6. Structured Design with the SIZE Property 


In this design, the 4-bit three-state buffer is driving 
64 bits of memory. Four sections of an LS241 do 
not have the drive capability to handle 16 memory 
packages; the Packager would report a loading error. 
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The TIMES property is used to correct loading viola- 
tions in structured designs, as illustrated by 
Figure 4-7. 


SIZE=4B 


= SIZE=32B 
TIMES=2T 


Figure 4-7. Using the TIMES Property 


In this example, the TIMES property tells the system 
that two instances of a 4-bit three-state buffer are 
needed. The system checks the loading and bal- 
ances the load between all the parts being driven. 
Using the TIMES property in this design is equiva- 
lent to adding another part and more interconnec- 
tions, as illustrated in Figure 4-8. 
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SIZE=32B 


SIZE=4B 


Figure 4-8. Manually Balancing Loads 


The Standard Library 
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Using the TIMES property eliminates the need to 
manually balance the load and enter more data. 


Valid provides a library of standard parts that allow 
you to define and manipulate signals in a structured 
design. The Standard library is automatically asso- 
ciated with your search list of SCALD directories so 
you can conveniently use these parts in your designs. 
Although the bodies in the Standard library can be 
used for any of the design techniques, many of them 
are created especially for structured designs. 
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See the Library Reference 
Manual for illustrations and 
descriptions of the bodies in 
the Standard Library. 


Benefits of 
Structured Designs 


Considerations Of 
Structured Designs 
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The library contains merge bodies for merging sig- 
nals, and tap bodies for tapping bits from buses, as 
well as several other special parts. 


Using a structured design technique has these 
advantages: 


e Creating structured designs can dramatically 
decrease the design cycle time. The amount 
of data entered into GED is reduced, result- 
ing in faster schematic entry. Also, the 
analysis tools run more efficiently on struc- 
tured designs because they can process multi- 
ple bits in parallel. 


e Errors in design entry are minimized because 
of the reduced number of parts and simpli- 
fied interconnections. 


e The resulting print is less cluttered, easier to 
read, and easier to understand. 


Creating a structured design results in logical repre- 
sentations of parts that represent many physical 
packages. Therefore, a structured design cannot be 
entirely back annotated because there is no one-to- 
one correspondence between the logical and physical 
designs. Backannotation is performed wherever it is 
possible, as shown in Figure 4-9. 
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SIZE=4B 
U2 


SIZE=4B 


Figure 4-9. Backannotation of a Structured Drawing 


Since the inverter represents a single section of a 
physical package, both the designator and pin num- 
bers are back annotated. The LS08 has four sec- 
tions per package, so the physical location designa- 
tor (U2) is back annotated, but no pin numbers are 
annotated. Since the LS74 has only two sections to 
a physical package, neither the designator nor the 
pin numbers are displayed. 


The Packager produces an easy-to-read cross refer- 
ence listing for the logical-to-physical mapping of 
the design data. These listings are used with the 
structured print set for design troubleshooting. 
Members of the design team responsible for trouble- 
shooting the structured design must be educated in 
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how to read structured print sets and how to refer- 
ence the physical information. 


For those designers who create a structured or hier- 
archical drawing but want to produce a conventional 
flat drawing, the optional ValidFLAT/Transcribe 
Schematic Flattener is available. This tool trans- 
forms a structured and/or hierarchical design into a 
flat drawing that shows every pin and part explicitly. 
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Hierarchical 
Designs 


Creating a 
Hierarchical Design 


1/15/89 


The hierarchical design technique is an efficient ap- 
proach to developing complex designs that can be 
organized into modules. This method is useful for 
designs that re-use many of the same circuit func- 
tions and for isolating portions of the design for 
teamwork assignments. 


A hierarchical design results in print sets that are 
easy to read and produces modules that can be ef- 
fectively debugged. Hierarchical designs, like struc- 
tured designs, reduce the amount of data entry and 
interconnections required by the design, thereby re- 
ducing the chance for error. Also, all the SCALD 
design tools can be used to analyze partial designs 
(modules). 


Creating a hierarchical design is a natural extension 
of the entire design process. If the design to be im- 
plemented is a computer, the design begins by plan- 
ning the constituent parts of the computer. 


The computer can be divided into CPU, MEMORY, 
and I/O modules. The CPU module can be further 
divided into ALU, MEMORY, and CONTROL mod- 
ules. This represents three levels of hierarchy in the 
design. There are no limits to the number of levels 
you. can include in a _ hierarchical design. 
Figure 4-10 shows the hierarchical levels of the 
computer. 
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| CONTROL MEMORY 


Figure 4-10. Levels of Hierarchy 


After the modules of the design are planned, imple- 
menting the design uses the following basic 
procedure: 


1 Create a LOGIC drawing that represents a 
functional portion (module) of your design 
(for example, counter, register file, memory 
unit, or control blocks of circuitry). You can 
start at the most detailed level of the design 
hierarchy. 


2 Test that drawing, processing it with other 
Valid programs to check its timing and logic 


4-18 1/15/89 


Design Techniques 


functions. You can efficiently debug each 
module of the design as you work. 


3 Create a BODY drawing to represent the de- 
sign module. 


4 Create a new LOGIC drawing and add the 
required number of BODY representations to 
it, building a circuit using the modules. You 
have added a symbol that represents the 
functional module you created in Step 1. The 
BODY drawing acts as a pointer to the 
LOGIC definition of the circuit. 


5 Continue to create the corresponding LOGIC/ 
BODY representations for each of the de- 
fined modules in the design, working up the 
levels of hierarchy. 


Figure 4-11 illustrates LOGIC and BODY drawings 
defined for use in a hierarchical design. Instead of 
having to wire together the gates of the Full Adder 
circuit whenever it is needed, you add _ the 
Full Adder.body drawing in its place. 
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FULL ADDER. BODY. 1.1 


AG 
Beé 


Figure 4-11. Full Adder Logic and Body Drawings 


Every level of hierarchy (except the lowest level) is 
made up of a LOGIC and BODY drawing pair. The 
LOGIC drawing defines the functional circuitry for 
the design module. The BODY drawing is the pic- 
ture or symbol that represents the logic function. 
The BODY points to the functional representation, 
but does not take up as much space in higher levels 
of the hierarchy. The result is a well organized and 
understandable design print set. 
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Creating Bodies 


For more information on 
creating bodies, see the 


Library Reference Manual. 


For more information 
on signal syntax, see 
the SCALD Language 
Reference Manual. 
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When you create a hierarchical design, you draw 
simple shapes (bodies) to represent the specific logic 
for each element of the design. GED provides you 
with the tools for drawing bodies and establishing 
the relationships between the body drawings and the 
logic drawings they represent. 


The pins on the bodies that correspond to signals in 
the logic drawing must have the same name. Addi- 
tionally, these signals in the LOGIC drawing are 
given the interface signal property (Al). This signal 
property is used to indicate an interface signal from 
a higher level drawing. 


Follow these steps to use GED to create a body 
drawing: 


1 Edit a drawing with the BODY extension. 


A grid is displayed, with an X to mark the 
origin of the body. The grid for BODY draw- 
ings is twice as fine as the value set in by 
set default_grid. The initial system default 
grid for BODY drawings is 0.05 inches. 


2 Split the name from the origin with the split 
command. The origin of the body becomes 
its vertex when the body is later added to 
LOGIC drawings. The origin should not be 
at a connection point (pin end) for the body. 


3 Use the wire command to build the outline of 
the body around the origin body. The grid is 
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See page 4-23 for infor- 
mation about defining 
low-asserted pins. 


Use the wire command 
and press the white button 
to display diagonal lines. 
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used as a guideline for the appropriate size 
and shape of the body. 


Add wire stubs for the pins. They should be 
0.1 inch (one grid segment) long. Be sure to 
place the pins on grid lines so that the body 


can be correctly wired on LOGIC drawings. 


Use the dot command to place a dot at the 
end of each pin. Dots should be placed on 
displayed grid intersection points. Press the 
blue button to ensure that the dot is properly 
placed at the end of the wire. 


Use the signame command to add pin names 
(corresponding to the signal names in the re- 
lated logic drawing) to each pin. The name 
must match the corresponding name in the 
logic drawing exactly except for the omission 
of the interface property (\I). Use the 
show attachments command to ensure that 
all pin names are attached properly. 


Use the note command to place labels within 
the body drawing. This makes the purpose of 
the body and each pin clear. 


~ Mark the clock signal with a wedge. 


Use the write command to save the BODY 
drawing. 
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Defining Low Asserted Use a circle instead of a wire to represent a low- 

Pins asserted (bubbled) pin. You can use either the 
circle or arc command to add circles. The circle 
should be 0.1 inch in diameter. A dot is placed on 
the appropriate grid intersection point on the cir- 
cumference of the circle to mark the connection 
point. The signal name should also be low—asserted 
(*). Figure 4-12 shows an example of using a low- 
asserted pin. 


IN>k OUT 


Figure 4-12. Using a Low-Asserted Pin 


To define pins that can be either bubbled or un- 
bubbled, draw a body and represent the pins with 
both wires and circles. There must be a line that 
goes across the diameter of the circle so that both 
representations are available. Be sure to place a dot 
at the connection point. You also attach the 
BUBBLE property to the origin of the body to define 
which pins are bubbled when the part is added to a 
drawing. 
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See the Library Reference You can also define groups of pins that automati- 

meal more information _| cally change state when one of the pins in the group 
UBBLE_GROUP 

ai aaa is bubbled. These are called bubble groups. 


property. 


BUBBLED=< Y> 1p 
BUBBLE_GROUP=< Y | A> 


AQ <STze=1.. Bs Y <SizZe—1... Osx 


Figure 4-13. Using Bubbleable Pins 


When you add the body to a drawing, use the 
bubble command to toggle the pin from bubbled to 
unbubbled. 


Creating Body Versions You can create different versions of your body draw- 
ings similar to the versions supported in Valid librar- 
ies. The BODY drawings refer to the same LOGIC 
drawing. Use the edit command to begin a drawing 


See the Library Reference for another version of a body: 
Manual for more information 
about creating bodies. edit circuit.body.2.1 


Multiple versions can be useful when different sizes 
of the body are required on the logic drawing or 
when graphically different, but functionally equiva- 
lent, representations of the body are required. 
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GED and the SCALD language have several features 
for creating versions of parts. 


e You can make a version that is sizeable. 
e You can make a version with bubbled pins. 


e You can make a version with pins assigned to 
bubble groups so that certain pins are auto- 
matically bubbled when one pin from the 
group is bubbled. 


ADDER 
ADDER 


Figure 4-14. Versions 1 and 2 of FULL ADDER.BODY 


When the body is added to a drawing, you can use 
the version command to display the required repre- 
sentation of the body. 
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Benefits of The benefits of creating hierarchical designs are 
Hierarchical Designs similar to those of structured designs: 


Creating hierarchical designs can dramati- 
cally decrease the design cycle. Since the 
BODY drawings act as pointers to the LOGIC 
drawings, a large amount of repetitious data 
entry is eliminated. 


The Compiler is optimized to operate on hier- 
archical designs. The functional LOGIC 
drawing that a BODY represents can be com- 
piled once and linked to all locations where 
that body is used. 


Because the amount of schematic entry is re- 
duced, the number of entry errors is 
minimized. 


Since functional modules are created when 
defining a hierarchical design, each module 
can be fully tested before it is incorporated 
into higher levels of the design. Testing can 
be performed incrementally rather than at the 
end of the design process. 


Hierarchical designs result in designs that are 
well organized and easy to read and 
understand. 


Considerations of Keep these considerations in mind when planning a 
Using Hierarchy hierarchical design: 
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Hierarchical designs do not have a one-to- 
one relationship between logical and physical 
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parts. Therefore, a hierarchical print cannot 
be backannotated. 


For those designers who create a structured 
or hierarchical drawing but want to produce a 
conventional flat drawing, the optional 
ValidFLAT/Transcribe Schematic Flattener is. 
available. This tool transforms a structured 
and/or hierarchical design into a flat drawing 
that shows every pin and part explicitly. 


The cross-reference listings generated by the 
Packager contain physical information for 
every part in your design. The listings and 
print sets are used for design troubleshooting. 


e Members of the design team responsible for 
troubleshooting the design have to be taught 
how to read hierarchical print sets and how to 
reference the physical information in the 
cross-reference listings. 


Comparing The design methodologies discussed in this section 
; (flat, structured, and hierarchical) are all appropri- 
Design ate for solving different of design problems. You 


Techniques must weigh the benefits and considerations of each 
technique before deciding which method to use. 


In addition to using the individual methods, there is 
no restriction against combining them in design 
drawings. Hierarchical and structured design tech- 
niques are often used together to provide maximum 
flexibility and efficiency for the design engineer. 
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Table 4-1. Comparing Design Technic 


Best Suited For: Small designs 
Designs that do not re-use modules 
Designs that do not use buses 


Benefits: Fully back annotated print sets 
Short learning curve 


Considerations: Long design cycle time 
Cluttered print sets 


Structured Designs 


Best Suited For: Designs that use sophisticated bus structures 


Benefits: Shortened design cycle time 
Fewer errors during data entry 
Less cluttered print sets 
Print sets organized in logical flow of design 
Cross reference listings 


Considerations: Partially back annotated print sets 
Additional training required for design troubleshooters 


| Hierarchical Designs 


Best Suited For: Designs that re-use modules 
Large designs that can be organized into separate components 


Benefits: Shortened design cycle 
Fewer data entry errors 
Easy-to-read print sets 
Cross reference listings 
Effective debugging capability 
Print sets organized in logical (top down) flow of design 


Considerations: Partially back annotated print sets 
Additional training required for design troubleshooters 
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Producing a 
Hardcopy 


This section explains: 
@ Using the hardcopy command within GED 


e Producing a hardcopy drawing from the 
operating system 


e Creating plot files 
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The hardcopy command sends drawings to a plotter 
to produce a hardcopy of a drawing. 


Use the hardcopy command to: 


e Send a drawing to a plotter attached to your 
system. 


e Send a drawing to a plotter attached to an- 
other system. 


e Create a plot file that can be printed at a later 
time. 


Several brands and sizes of plotters are supported. 
Although direct connections to all plotters are not 
supported on all platforms, network facilities allow 
you to do remote plotting. 
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Using the 
Hardcopy 
Command 


See Creating Plot Files, 

page 5-5, for informa- 
tion about creating plot 
files that can be printed 
at a later time or trans- 
ported physically to an- 
other system. 


set plotter w1liversatec 
set plotter 59429 
set plotter calcomp1043 


set plotter hp7475 or 
set plotter hp7580 
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The hardcopy command plots files on the specified 
printer as long as your system has been properly 
configured. Refer to the appropriate Guide to Opera- 
tions or System Manager’s Manual for more 
information. 


If necessary, issue the set local_plot command (de- 
fault). This command automatically plots the draw- 
ing on the correct plotter. The plotter can be either 
directly connected to your workstation or on the net- 
work, as long as your system is configured properly... 


Issue the set command to specify the device where 
the drawings are to be sent. The set command can 
be issued during the editing session or placed in the 
startup.ged file. 


For example: 

Selects the 11-inch versatec plotter. 
Selects a Benson plotter. 

Selects a Calcomp plotter. 


Selects the specified Hewlett-Packard plotter. 


Refer to the Guide to Operations manual for your sys- 
tem for a listing of supported plotters. Refer to the 
ValidGED Command Reference Manual for more in- 
formation on the set command. 


After you tell the system which plotter is being used, 
the hardcopy command requires a scale factor entry 
and a drawing name. 
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scale factor 


drawing name 


hardcopy 


hardcopy a 


hardcopy c *.logic* 


hardcopy .5 hyper mux 


The scale factor allows you to determine the size at 
which the drawing is plotted. The default scale fac- 
tor is 1. You can enter a number or a page size to 
vary the size of the plotted drawing. If a page size 
is given (letters A through E), the plot is adjusted to 
that size. If a real number is entered, the plot is 
scaled from the default size. 


If you specify a drawing name, you MUST specify a 
scale factor (a real number or A - E). 


If no drawing name is given, the current drawing is 
plotted. The drawing name does not have to be the 
currently edited drawing nor in the current working 
SCALD directory. 


If the drawing is from a SCALD directory other than 


the current working SCALD directory, the directory 


name must be given (<dir.wrk>drawing name.logic*). 


For example: 


Plots the current drawing at the drawing’s default 
scale. : 


Plots the current drawing on an A size page. 


Plots all LOGIC drawings in the current directory on 
C size pages. 


Plots all drawing types for the drawing “hyper mux” 
(BODY, LOGIC, SIM, etc.) at half size. 
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Creating Plot 
Files 


1/15/89 


GED provides facilities which allow you to create a 
plot file that can be printed at a later time, physi- 
cally transported to another system, or transferred to 
to the Interleaf™ publishing system for incorporation 
into a document. This plot file contains all the 
graphic information about the drawing. 


To create a plot file: 


1 Use the set command to change to 
spooled plot mode from the _ default 
local_plot mode. 


2 Use the set plot plotter command to specify 
the device on which the plot file is to be 
plotted. 


3 Issue the hardcopy command to specify the 
drawing to be plotted and any scale or page 
size options. 


This process creates a file named vw.spool, which is 
specific to the plotter you defined with the set com- 
mand. You can then transfer the file by diskette, 
tape, or over the network to a system that supports 
the specified plotter. 
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See the appropriate Guide On a SCALDsystem or Sun workstation, you can use 
to Operations or System either the vpr or vp/ command to plot the vw.spool 


Manager’s Manual for ‘ 
: ace file on a local or remote Versatec plotter. Your sys- 
more information about 


network plotting with your tem must be configured properly for the command 
workstation. to work. 
To plot the vw.spool file, type the command: 


vpr vw.spool 


If you want to include a GED drawing in an Interleaf 
document, follow these steps: 


1 Create a vw.spool plot file. 


2 Transfer the vw.spool file to an Interleaf desk- 
top. It appears on the desktop as an ASCII 
file. 


3 Open the ww.spool image, copy it, and place it 
into an Interleaf document. 


The GED drawing is in vector format and is 
fully-editable by the Interleaf software. 
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Standalone 
Hardcopy 


“option 
—f 


—a 


—-V 


outputtile 


otherinputtfile inputfile 
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To produce hardcopies of GED drawings directly 
from the operating system (without entering GED), 
you use the hpf command. 


hpf [-option outputfile] [-2 otherinputfile] inputfile 


Can be either -f, —a, or —Vv. 
Writes the data to a new version of outputtfile. 


Appends data to an existing outputfile; if outputfile 
does not exist, creates a new file. 


Writes a vector format file to a new version of 
outputtile. 


On the VMS operating system, if outputfile is not 
specified, output is written to the file P.SPL, and a 
DCL command file (see the Guide to Operations) is 
used to send the file to a plotter. If the outputfile is 
specified as a dash (—), output is written to 
SYSSOUTPUT. The dash output file can be used 
with the -f and -a options. On UNIX, if no 
outputfile is specified, hpf pipes the output to Ipr. 


Either one or two input files can be specified. The 
first (perhaps only) contains the hardcopy header. 
If there is only one input file, the plot data must 
immediately follow the four line header. Libraries 
cannot be specified. If two input files are specified, 
the first contains the hardcopy header and any li- 
brary specifications, and the second contains the 
plot data. 
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Hardcopy Header 
File Format 


All the fields of the 
header format file are 
followed by a newline 
character. 


Type of plotter 


Line weight 


Font type 


The hardcopy command can plot ASCII vectorized 
format files, ASCII component (body) files, or GED 
binary format files. The file that hardcopy reads 
has a special header at the top containing informa- 
tion about the type of plotter, line width, scale, and 
the format of the graphical information. In addition, 
if the file is binary, the header contains a list of 
rooted paths of SCALD directories to search to find 
bodies. 


The format of the hardcopy input file follows. 


Refer to your system’s Guide to Operations manual 
for a listing of supported plotters. 


Line weight can be: 
1 NORMAL WEIGHT lines 
2 HEAVY_WEIGHT lines 
The default is 2. 


The font type parameter appears on the same line 
as the line weight parameter. Font type is op- 
tional. The available font types are: 


e vector font (Default) 
e valid_font 

e milspec_font 

e gothic_font 

e cursive_font 

e greek _font 

e symbol_font 


e native_font (For built-in plotter fonts) 
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Scale 


Coordinates-per-inch 


Encoding type 


Directory paths 


Encoded drawing 
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Scale can be: 
e An ASCII positive real number string 


e A capital letter drawing page size (A, B, C, 
D, or E) 


Illegal scales default to 1.0. 


Coordinates-per-inch is an optional parameter 
which appears on the same line as the scale pa- 
rameter. Coordinates-per-inch is an ASCII inte- 
ger. If the coordinates—per-inch parameter is not 
included, any real number scale is assumed to be 
pre-compensated for the target plotter’s bits. per 
inch coordinate system. (hardcopy multiplies the 
incoming coordinates by the scale to get correct plot- 
ter coordinates.) 


Encoding type can be: 
V Vectorized 
B Binary 
Cc Component or body 
An illegal type causes the hpf program to abort. 


A list of rooted SCALD directory paths follows the 
encoding type only if the encoding type is binary (B). 


This is usually put in the second input file, but can 
be put here, directly following the four-line header. 
On VMS, if there are libraries specified, you must 
use the -2 option. 


Several different header types are shown in 
Figure 5-1. 


Producing a Hardcopy 
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hp7580 HP 7580 pen plotter 
1 milspec_font NORMAL lines, milspec font 
D scaled to D size 
V Vectorized format file 


sun _ workstation 

vers11 11-inch Versatec: 
2 gothic_font HEAVY lines, Gothic font 
B scaled to B size 
B binary format file 
/usr/valid/pdh/pdh.wrk directories to seach for bodies 
/usr/valid/lib/standard/standard. lib 

/usr/valid/lib/Isttl/Isttl. lib! 


SCALDsystem 
vers11 11-inch Versatec 


NORMAL lines, default font 
scaled to A size 
binary format file 
/u0/tih/tIlh.wrk#scald directories to search for bodies 
/u0/lib/standard/standard. lib 
/u0/ib/Isttl/Isttl. lib! 


VAX workstation 

calcomp1043 CalComp 1043 pen plotter 

: NORMAL lines, default font 

scaled to E size 

binary format file 

$disk2: [jao]jao.wrk directories to search for bodies 
scald$root: [libraries.standard] standard. lib 

scald$root: [libraries. Isttl] Isttl.lib 


Figure 5-1. Examples of Hardcopy Headers 


Note: Comments cannot appear in a hardcopy header. They are 
included in this table for your information only. 
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Standalone 
Hardcopy 
Procedures 


Note: There must not be any 
extra lines after the last SCALD 
directory path or hardcopy will 
not work properly. 


VAX Workstation 


Sun Workstation 


SCALDsystem 


The information in hardcopy input file format al- 
lows you to create hardcopies without entering GED. 
Follow this procedure to use the hpf program: 


1 Create a header file with all the information 


on plotter, font, scale, file format, etc. 
Figure 5-2 shows an example header file 
called bsizehp7580.header. 


hp7580 
1 


B 

B 

$disk2: [jao]jao.wrk 

scald$root: [libraries.standard]standard. lib 
scald$root: [libraries. Isttl]Isttl.lib 


hp7580 
{ 


B 

B 

/usr/valid/jao/jao.wrk 
/usr/valid/lib/standard/standard.lib 
/usr/valid/ib/Isttl/Isttl. lib 


hp7580 
{ 


B 

B 

/u0/jao/jao.wrk 
/u0/lib/standard/standard.lib 
/u0/lib/Isttl/Isttl. lib 


Figure 5-2. Example Header File 
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UNIX: 


VMS: 


UNIX: 


VMS: 


2 Enter the name of the binary drawing file 


that you want to plot. In most cases, it is 
easy to determine the name of the directory 
that contains your drawing; for example, the 
drawing MY LOGIC would be in the directory 
mylogic. If you have many similarly named 
drawings, look in your SCALD directory 
(user.wrk file) for the mapping between GED 
drawing names and the corresponding system 
directories. 


Each drawing directory contains a file which 
is the binary format GED file. The file is 
called: 


logic_bn.version.page 
logic_bn$version$page.dat 

In this example, the binary file is: 
/usr/valid/jao/mylogic/logic_bn.1.1 


$DISK2: [JAO.MYLOGIC]LOGIC_BN$1$1.DAT 
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Producing a Hardcopy 


3 Use one of the following procedures to create 
and plot the plot file. 


VMS Create the plotter file with the following 
command: 


$ HPF -F PLOTTER.OUT -2 BSIZEHP7580.HEADER -— 
$DISK2: [JAO.MYLOGICDRAWING] LOGIC _BN$1$1.DAT 
If $PLOTTER and SYS$PLOT are set up as 
described in “Local Plotting” in the Guide to 


Operations, you can plot this file with the 
command: 


$ PRINT/DEVICE=SYS$PLOT PLOTTER. OUT 


UNIX Use one of the following commands: 


% cat bsizehp7580.header mylogicdrawing/logic_bn.1.1 | hpr 


| or 


% cat bsizehp7580.header mylogicdrawing/logic_bn.1.1 > hpr.infile 


% hpr hpr.infile 
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Adding Physical 
Information 


This section explains: 
e Back annotation 
e Manual physical part assignments 


e The chips_prt file 
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Adding Physical Information 
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After completing the logical design, you can add in- 
formation about the physical part assignments to the 
drawing. You can include part reference numbers 
(U-numbers) and pin numbers on the drawing. 


To do this, use the backannotate command to auto- 
matically add information generated by the Packager 
and the physical design system. You can also manu- 
ally add physical information with GED commands. 
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Back Annotating 
the Design 


1 GED 


2 PACKAGE 
3 BACKANNOTATE 


4 physical interface program 


5 physical design system 


6 PACKAGE 


7 BACKANNOTATE 
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Back annotation brings physical design information 
from the Packager and adds it to the logic design 
drawings. Generally, you back annotate the design 
after the first error-free run of the Packager and 
then again after the design has been processed by a 
physical design system. 


There are seven typical steps in the design and 
processing of a drawing: 


Schematic capture: Create the logical design. 


Analyze the design further and prepare for use by a 
physical design system. 


Add physical design information generated by the 
Packager to the design. 


Format the design for the physical design system. 


Produce the circuit from the design and prepare for 
manufacturing. 


Reassign physical parts based on feedback files 
from the physical design system. 


Update the GED drawing to reflect the actual 
physical design of the circuit. 


Physical information is added to a drawing through 
back annotation as soft properties. This information 
is interpreted differently than properties added 
manually to a drawing. GED considers back anno- 
tated information to be comments that are not out- 
put to the connectivity file. That is, back annotated 
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information does not appear in the SCALD system 
database; it only resides in the drawings. Back an- 
notated information cannot be manually changed or 
reattached, but it can be moved or deleted. 


Properties added by the backannotate command 
begin with the dollar sign character ($). For in- 
stance, a LOCATION property added by the 
backannotate command is represented as: 


$LOCATION 


Back annotation typically adds $LOCATION and 
$PN properties to the drawing. The next time you 
back annotate the drawing, the updated information 
replaces the existing values (a new $LOCATION 
value replaces an old $LOCATION value). 


One of the files created by the Packager is the back- 
annotation file, named pstback.dat. This file con- 
tains the physical part assignments the Packager 
made in a format that GED can understand. The 
backannotate command automatically adds this in- 
formation to the drawing. This ensures that your 
drawing accurately reflects the physical part assign- 
ments and saves time and tedious work. 


Follow this procedure to use the backannotate 
command. Before you begin, if you wish to save the 
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NOTE: If you copied the 
pstback.dat file to backann.cmd, 
you do not have to specify the 
name of the file; GED automati- 
cally reads backann.cmd by de- 
fault. 


Displaying Pin 


Numbers 
near_pn 
far_pn 
rotate 
pin_size 
1/15/89 


original pstback.dat file, copy it to a file called 
backann.cmd. 


1 Enter GED and edit the required drawing. 


2 Type the command, followed by the name of 
the file containing the physical part assign- 
ments. For example: 


BACKANNOTATE pstback.dat 


GED reads the file containing the physical part as- 
signments and automatically adds the information to 
the drawing. 


The set command provides several options for con- 
trolling the display of pin numbers on the drawing: 


Controls the placement of pin numbers on the draw- 
ing. far_pn (the default) places the pin number to 
the upper-right of the connection if the connection is 
to the right of the origin of the body, and places the 
pin number to the upper-left if the connection is on 
the left side of the body. near_pn attempts to place 
pin numbers as close to the body as possible. 


Determines whether pin numbers annotated to verti- 
cal pins are rotated. The default is rotate on. 


Changes the size of added pin numbers. The de- 
fault is 0.80 times the default text size (0.082 
inches). The scale can be set to any real number; 
for example, 0.75. 
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Manual Physical 
Part 
Assignments 


LOCATION 


GROUP 


SEC 


The Packager directive 
HARD_LOC_SEC OFF allows 
the Packager to override 
manual assignments. See the 
ValidPackager Reference 
Manual for more informa- 
tion. Otherwise, to change a 
manual assignment, you must 
delete the information or 
manually assign new infor- 
mation. 


When you use GED commands to make physical 
part assignments, you are adding hard properties to 
the drawing. These properties are not altered by the 
Packager and are not changed when you back anno- 
tate the drawing. For example, you can attach the 
LOCATION property to a body to ensure that the 
part is assigned to a specific physical designator. 


The hard properties used to add physical informa- 
tion to the drawing include: 


Assigns a particular physical part to a logical body 
on a design. The LOCATION property should only 
be attached to bodies that represent physical parts. 


Groups logical parts to be in the same set of physi- 
cal packages when you are not concerned about the 
actual physical designator. Isolates parts of 
different groups. 


Assigns a logical body to a particular section within 
a physical part. This is accomplished with the 
section command. 


When you assign physical part information to the 
logical parts of a GED drawing, you commonly use 
the section command and the LOCATION property. 
When you use the LOCATION property and the 
section command to make physical part assign- 
ments, the Packager and the physical design system 
do not usually override the assignments. 


Use the property command to attach LOCATION 
properties to the bodies on a drawing. The 
LOCATION property is not restricted to 
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U-numbers; it can be any alphanumeric string. You 
can attach a LOCATION property after packaging a 
design, but then you must recompile and repackage 
the design for the Packager to make use of the speci- 
fied information. 


Use the section command to select which section of 
a physical part is assigned to a particular logical 
part. To use the section command, edit the draw- 
ing and follow these steps: 


1 Use the window or zoom command to en- 
large the appropriate part of the drawing so 
that the part is clearly visible. 


2 Type: 
section 


3 Point to the origin of the body you want to 
assign a section and press the yellow button. 
To assign the sections of a full-chip repre- 
sentation of a part, point to a particular pin 
(not to the origin of the part). 


Each time you press the button, you select a 
different section of the physical part. The 
pin numbers on the entire body change 
accordingly. 


Alternately, you can issue the section command, 
type the pin number, then point to a pin. If you 
know exactly which section is required, this can save 
the time of cycling through the various sections. 
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You can use the section command on a body either 
before or after you compile and package the design. 
When you change section assignments after back an- 
notation, you assign just the sections you want to 
force and leave the others. The schematic may then 
have some duplicate section numbers. When you 
recompile and repackage the drawing, the Packager 
reassigns the remaining sections. 


GROUP=A 
1P 


LOCATION=U1 
4P 


Figure 6-1. Adding Physical Information 


In Figure 6-1, the properties that have been added 
have the following effects. 


LOCATION The LS74 has been given the physical location desig- 
nator, U1. Another LS74 that might occur in this 
drawing would be placed in this package to fill it. 
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GROUP 


See the ValidPackager 
Reference Manual for 
more information on 
grouping parts. 


SEC 


The Chips_prt File 


SCALDsystem or PC AT 


The LSOO parts are all placed in the same physical 
location designator because they have the same 
group name. The designator name is assigned by 
the Packager. Another LSOO in the drawing that has 
a different group name or no group name is not 
placed into the same package. You can, however, 
use the FREE GROUPING directive of the Packager 
to allow parts with no group name to be placed in a 
package with parts that have a group name. 


The section command was used on two of the LS00 
parts to assign the exact section to those logical 
parts. The LS0O at 3P is assigned to a section by 
the Packager. 


Only parts having a chips_ prt file can be affected by 
the section and pinswap commands. Only pins 
having the pin_group property in a chips_prt files 
can be affected by the pinswap command. The 
chips_ prt files for each part in a library are made by 
dividing the library chips file (/ib.prt) into individual 
files for each part. In UNIX, the chips file is called 
chips_ prt. In VMS, this file is called chips_ prt.dat. 


On a SCALDsystem or PC AT, use the following 
command to divide a library chips file: 
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For example, use the following commands to divide 
the 100K library: 


% cd /u0/1ib/100k 
% /usr/bin/makechipsfiles 100k.prt 100k.1lib 
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The new files are stored in the subdirectory for each 
part; for example: 


/u0/1ib/100k/100171/chips_ prt 
is the individual chips file for the 100171 device. 


Sun Workstation On a Sun workstation, use the following command 
to divide a library chips file: 


/usr/valid/tools/bin/makechipsfiles /ibrary_chips_file SCALD_directory_file 


For example, use the following commands to divide 
the 100K library. 


% cd /usr/valid/tools/libraries/100k 


.prt 100k.1lib 


The new files are stored in the subdirectory for each 
part; for example: 


/usr/valid/tools/libraries/100k/100171/chips_prt 
is the individual chips file for the 100171 device. 


VAX Workstation On a VAX workstation, use the following command 
to divide a library chips file: 


$MAKECHIPSFILES library chips_file SCALD_directory_file 


For example, use the following commands to divide 
the 100K library: 


$ SET DEFAULT SCALD$ROOT: [LIBRARIES.100K] 
$ MAKECHIPSFILES 100k.prt 100k.1lib 
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SCALDsystem or PC AT: 
Sun workstation: 


VAX workstation: 


SCALDsystem or PC AT: 


Sun workstation: 


VAX workstation: 
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The new files are stored in the subdirectory for each 
part; for example: 


SCALD$ROOT: [LIBRARIES. 100k.100171]chips_prt.dat 
is the individual chips file for the 100171 device. 


To use the section and pinswap commands, instal- 
lations must have the following program: 


/u0/scald/section/section 
/usr/valid/tools/section/section 
SCALD$ROOT:[SECTION]SECTION.EXE 


This is the program that computes the section and 
pin assignments for the various parts. The files are 
included with GED. 


Installations must also include the following files: 


/u0/scald/section/secassign.sh 
/u0/scald/libtools/makechipsfiles 


/usr/valid/tools/section/secassign.sh 
/usr/valid/tools/libtools/makechipsfiles 


SCALD$ROOT: [LIBTOOLS] MAKECHIPSFILES.COM 


Mixing Text and 
Graphics 


This section explains: 
e Adding drawings to existing ion files 
e Creating documents interactively 
e Changing an existing document 
e Printing a document with GED 


@ Using font styles 
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Mixed Text and Graphics 


You can create mixed text and graphics documents 
interactively using the GED set of graphics tools. 
You can also add graphics to existing text. The 
need to physically “paste-up” drawings into text is 
eliminated. 


Adding The GED format command is used to add drawings 
: to an existing text file. By adding the drawing 
Drawings to names to the existing text files and then formatting 
Existing Text with GED, you eliminate the need to physically cut 
“ and paste illustrations into the document. 
Files 


Documents made using the format command are 
called DOC drawings in GED. Editing a DOC draw- 
ing is different from editing a regular schematic 
(LOGIC, TIME, BODY). First, the grid is initially 
set up so that there are 6 grid spaces per inch on the 
final plot (the grid is set to 0.166). In addition, 
when a DOC drawing is written, only the ASCII and 
binary representations are saved. There is no need 
to create a connectivity representation because DOC 
drawings are not read by the Compiler. 


Refer to the appropriate The text file should be created with a text editor 

reference documentation such as wi or EDT using a text formatter such as 

en nroff or Digital Standard Runoff. However, the de- 
fault page length is too long for the font created by 
GED. To create pages with 59 lines, use a format- 
ting command to set the page length to 59 at the 
beginning of the file. 


To add a GED drawing to a text file, you include 
two special formatting commands and then insert 
the specified number of blank lines at the location in 
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the text where the drawing is to appear. Follow this 
procedure: 


Remember to use the com- 1 To specify the drawing, place an ampersand 

plete drawing name syntax: ; ; 

adie ype.version pape. (&) in the first column _ then type the 
name of the SCALD drawing. 


2 In the first column of the next line, type the 
number of lines required for the drawing 
(6 lines = 1 inch). 


3 On the next line type the formatting com- 
mand to insert the number of blank lines you 
specified. This allows GED to properly 
format each page. 


& AN EXAMPLE.LOGIC.1.1 
12 
-Sp 12 


4 Save your text file and then issue the format 
command: 


format filename ({CReturn 


drawing_name 


GED accesses the drawings specified in the text file, 
smashes them, and scales them to fit into their ap- 
propriate spaces. GED saves this new text and 
graphics document in the drawing name you 
specified to the format command. 
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The arguments to the format command are: 


e The name of the text file 


A Geum) 


e The drawing name 


format then creates a document called 
drawing_name.DOC. The text file has been pre- 
processed by a text formatting program (for exam- 
ple, nroff or Runoff). Each page of the text file is 
turned into a page in a SCALD drawing. A page 
ends after 60 lines or after a user-inserted formfeed 


(Controd)-L). 


Each page created by format is 8-1/2 by 11 inches, 
with 6 lines per inch. The characters are slightly 
larger than the GED default character font (1.29 
times the default) for easier readability. The format 
command also adds tick marks on the corners of the 
document pages to facilitate cutting the plotted out- 
put to the correct size. 
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Creating 
Documents 
Interactively 
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Creating a document with GED requires being able 
to add both text and drawings. To add text lines, 
use the note command or create a file of text using 
a text editor and then add it to the GED document 
using the filenote command. To add a figure, cre- 
ate the drawing with GED and add it to the docu- 
ment using the scale command. 


For example, use the following procedure to create 
the sample document shown in Figure 7-1: 


1 


Use a text editor to create a file called 
mux. txt. 
Enter the following text: 


The 2 to 1 MUX. If S is high, 
the output, Y, is Il. If S is 
low, the output is I0. 


Enter GED and create the mux.body 
drawing. 
Use GED tto edit a drawing called 
example.doc. 
Type: 
filenote mux.txt 

and point to the spot where the note should 
go. 
Use the scale command to add the drawing. 
Type: 

scale mux.body 


and point to the opposite corners of the rec- 


tangle where the figure should go. 
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The scale command causes all bodies to be 
smashed into their primitive pieces; the BODY defi- 
nition is not maintained. 


The 2 to 1 MUX. If S is highs the outputs 
Y a1s Ii. If S is low, the output is Id. 


*K 


<SCALE> 


becomes 


The 2 to 1 MUX. If S is highs the output: 
Y 18 I1. If S is tows, the output is Ia. 


BUBBLE_GROUP=c¢«T1:I0:Y> 


Ii <SIZE-1..@> 
Y <SIZE-1..@4> 


IQ@ <SIZE-1..@> 


Figure 7-1. The Example DOC Drawing 
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Changing an Once a document is created, either using the format 
ee command or interactively using the filenote and 
Existing scale commands, it can be edited using GED. You 


Document may want, for instance, to rescale figures or make 
simple changes to lines of text. Modifications can 
be made using regular GED commands such as 
move, copy, change, wire, and group. 


For example, Figure 7-2 is an existing document 
that needs several changes made. 


The ’?181s *’LS181; and ’S181 are 

arithmetic logic units ¢ALUD/Ffunction 
generators that have a complexity of 

75 equivalent gates on a monothic chip. 
These circuits perform 16 binary arithmetic 


operations on two 4-bit words. These 
operations are selected by the four 
function-select [ines ¢(S@ Sls S2; S3) 
and include additions subtraction 
decrements and straight transfer. 


Figure 7-2. An Existing Document to Edit 


1 The word ‘‘monolithic” is misspelled in the 
third line. This can be corrected with the 
change command. 


2 Use the wire command to underline the chip 
names. 
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3 The scale of the drawing is too small. Define 
a group around the drawing and then delete 
the group. Use the scale command to add 
the drawing at a larger scale. 


The changed drawing is shown in Figure 7-3. 


The 21fil, ’LSifil, and ’Sifl are 

arithmetic logic units cALUD/Ffunction 
generators that have a complexity of 

7S equivalent gates on a monolithic chip. 
These circuits perform 16 binary arithmetic 
operations on two 4-bit words. These 
operations are selected by the four 
function-select lines (S@; Sis S22, S3> 


and include additions subtraction 


decrements and straight transfer. 


Figure 7-3. The Existing Document Changed 
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Printing a 
Document With 
GED 


Using Font 
Styles 
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When a document is created using the format com- 
mand, tick marks are placed at the corners of the 
page. These tick marks serve two purposes. First, 
they allow you to hardcopy at the default scale 
(hardcopy 1) and get an 8 1/2 by 11 inch page. 
Second, the tick marks are used to cut the plotter 
paper to the correct size. Therefore, to ensure that 
the document is correctly plotted, do not delete the 
tick marks on the sides of the document or place 
text outside the tick marks. 


If the marks are deleted or the page is created 
manually, type the following to create the. tick 
marks: 


dot (410,4864); 
dot (410,-50); 
dot (4648,4864); 
dot (4648,-50); 


Make sure that all the text and graphics lie within 
the box created by the dots, and the page will al- 
ways be plotted correctly. 


GED supports a variety of printing font styles that 
you can use to print your documents. See Appen- 
dix B for a complete list and character sets. 


To specify a font, issue the set font command with 
the required character set name and then use the 
hardcopy command to plot the document. All text 
Strings in the design are plotted in the same font. 
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Drawing Maintenance 


This section explains: 
e Crash recovery procedures 


e Updating drawings 
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Temporary Files 
and Crash 
Recovery 
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When you edit a second drawing without writing out 
the first one, GED saves a copy of the first drawing. 
The saved drawing is in a temporary binary file and 
is named a0Qaaaa?.xyz. The two digits (00) refer to 
the workstation and window. The ? is a letter desig- 
nating the number of the temporary file stored in 
your operating system directory. Temporary files 
are not written into your SCALD directory. 


These temporary files are deleted from the operating 
system if GED terminates normally. However, when 
GED exits abnormally, all drawings except the last 
one can be restored to the versions saved in the 
temporary files. 


If GED or the system crashes, it is possible to re- 
cover the drawings that were being edited while 
GED was running. Every time GED is called to the 
screen after a system crash, a query appears as the 
first message from the editor asking if you want to 
recover files. In the event of a crash, you should 
recover files by answering “yes” to the question 
about recovering files. | 


If you elect to recover drawings, they are all placed 
in a SCALD directory called restore.wrk. The recov- 
ered drawings are called RESTORED1, RESTORED?2, 
and so on. If a restore.wrk SCALD directory already 
exists, it is overwritten. A warning message is 
printed regarding this, and it is possible to elect not 
to recover. 
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To access your recovered drawings: 


1 Type: 


use restore.wrk 


2 edit the drawings in reverse order. If there 
are drawings RESTORED1, RESTORED2, 
RESTORED3, RESTORED4, and RESTOREDS, 
start editing RESTOREDS and work back to 
RESTORED1. 


3 write the edited drawings with their correct 
names to the appropriate SCALD directory. 
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Updating 
Out-of-date 
Drawings 


Dependency Files 
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If library parts change, it is often difficult and time 
consuming to look through a SCALD directory to 
determine if any drawings are affected. An update 
facility is provided with GED to make this process 
easier. 


This update facility allows you to ask which draw- 
ings are out of date and then remake them, using 
the new parts. This is done from the operating sys- 
tem in a batch mode. 


When a drawing is updated, several processes are 
performed. First, a list of all the parts used by a 
drawing is compiled. This list is then used to deter- 
mine whether any of the parts in the library are 
newer than those in the drawing. Second, changed 
properties on parts are handled correctly. For in- 
stance, if a property on a part has been added or 
deleted, that property is added or deleted on the 
drawing. In addition, if you have modified a part 
property value, that value overrides any default 
value. 


The dependency file lists the bodies used by a draw- 
ing and the operating system directory from which 
the parts came. GED writes a dependency file in 
addition to the ASCH, binary, and connectivity files 
for each drawing. When you run the update facility, 
the date of each part is compared to the date of the 
last write for the drawing. If any of the parts are 
newer than the drawing, the drawing needs to be 
updated. 
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Drawing Maintenance 


Updating a Drawing 


-a “drawing name” 


-f “part name’”’ 
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You enter the gedupdate command at the system 
prompt to update the drawings in your directory. 


gedupdate argument 


The command arguments are: 


Find all drawings in the current directory that need 
updating and remake them. This option deletes the 
binary files and then reads in the ASCII versions of 
the drawings so that changes to properties are han- 
dled properly. 


Find all drawings in the current directory that need 
updating and produce a list of them. 


Find all drawings in the current directory that need 
updating and remake them. This option does not 
delete the binary versions first; consequently, if a 
binary version exists, the property changes are not 
handled correctly. This option is faster than the first 
option (no argument), and it is preferable if you 
know that only the body shapes have changed, not 
the properties. 


This option remakes the named drawing whether or 
not it is out-of-date. The drawing name should be 
enclosed in quotation marks and fully specified; 
wildcards are not allowed. For example: 


gedupdate -a "SIZE SHIFTER.LOGIC.1.1" 


This option finds and lists all the drawings that use 
the named part. Quotation marks enclose the part 
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Drawing Maintenance 


name on the command line, and the name itself fol- 
lows the same form as the add command. For ex- 
ample, to find all drawings that use the part 
3 MERGE, enter: 


gedupdate -f "3 MERGE" 


If you type in an unknown argument, a help message 
lists the arguments for gedupdate and the meaning 
of each. 


The search stack used to find the components in the 
drawings is defined in your startup.ged file. The 
drawings updated are those in the current directory. 
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GED Files 


This section contains information about the files and 
file structures used by GED, including: 


e System initialization files 
e ASCII files 

e Body files 

e Connectivity files 

e Dependency files 

e Back annotation file 


e Vector plot format 


GED Files 


System 
Initialization Files 


The Startup.valid 
File 


SCALDsystem and PC AT: 
Sun Workstation: 


VAX Workstation: 


The System 
Startup.ged File 


SCALDsystem and PC AT: 
Sun Workstation: 


VAX Workstation: 
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Several system files are used to initialize GED when 
you enter the system. 


The system-wide initialization file, startup.valid, de- 
fines the location of the master library file and some 
of the directories referenced by GED. 


This file also defines the default function key assign- 
ments for the workstation keyboard. On Valid 
SCALDsystems, startup.valid establishes the names 
of connections that can be used by the connect 
command. The connections specified are LED, 
CONCORDE, SIMULATOR, and COMPARE. 


The system location of this file is: 
/u0/editor/startup.valid 
/usr/valid/tools/editor/startup.valid 


SCALD$ROOT:[EDITOR]STARTUP.VALID 


The following script is run by the system-wide in- 
itialization file. Valid does not install or modify this 
file. The system administrator at individual sites 
uses this file to provide system-wide commands 
without changing the Valid-supplied file, 
startup.valid. 


The system location of this file is: 
/u0/editor/startup.ged 
/usr/valid/tools/editor/startup.ged 
SCALD$ROOT:[EDITOR]STARTUP.GED 
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GED Files 


The Softkeyassign 
File 


SCALDsystem and PC AT: 
Sun Workstation: 


VAX Workstation: 


The Config.dat File 


SCALDsystem and PC AT: 
Sun Workstation: 


VAX Workstation: 
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The softkeyassign file contains the default values of 
the function keys. Section 1 contains a listing of the 
default function keys. Refer to the assign command 
in the ValidGED Command Reference Manual for 
more information about programming the function 
keys. 


The system location of this file is: 
/u0/editor/softkeyassign 
/usr/valid/tools/editor/softkeyassign 
SCALD$ROOT: [EDITOR] SFTKEYASSIGN.DAT 

The config.dat file is used by GED to define the li- 
brary format for signal name processing. This file 
defines the characters that are used for signal name 
syntax (such as the asterisk to indicate a low as- 


serted signal). See the SCALD Language Reference 
Manual for more information on the config.dat file. 


The system location of this file is: 
/u0/editor/config.dat 
/usr/valid/tools/editor/config.dat 


SCALD$ROOT:[EDITOR]CONFIG.DAT 
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GED Files 


The Master.lib File 


SCALDsystem and PC AT: 
Sun Workstation: 


VAX Workstation: 


The master.lib file contains the name translations for 
the Valid part libraries. The file entries contain the 
abbreviated names for the GED library command 
and the file system location of the libraries. 


For example, an entry in master.lib on the 
SCALDsystem appears as: 


"Sttl" “’/ud0/lib/sttl/sttl.lib’; 
In VMS, the entry is: 
"sttl" “SCALD$ROOT: [LIBRARIES.STTL] STTL.LIB’ 


This entry makes a permanent “alias” for the STTL 
library so that it always refers to the pathname or 
file specification. Consequently, you can type: 


library sttl 


instead of typing the use command with the entire 
pathname or file specification. 


The system location of this file is: 
/u0/lib/master.|lib 
/usr/valid/lib/master.lib 


SCALD$ROOT:[LIBRARIES]MASTER.LIB 
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ASCII Files 
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One of the design database files that GED creates 
when a drawing is written is an ASCII file. An 
ASCII file is a script file that is used to represent all 
drawings except for BODY drawings. It is a specific 
type of text file that consists of commands to add 
each object in a drawing. GED “recreates” a draw- 
ing by reading the commands in the ASCII file; you 
can edit the ASCII file to make changes in your 
drawing. 


GED internal coordinates are 0.002 inches per unit 
by default. Points are represented in ASCII files by 
their coordinates, enclosed in parentheses and sepa- 
rated by a space. Thus, the point x=100, y=200 be- 
comes (100 200). 


Angles are represented by a number from -zero 
through seven: 


0 degrees 

90 degrees 

Mirror of 0 degrees 
Mirror of 270 degrees 
180 degrees 

270 degrees 

Mirror of 180 degrees 
Mirror of 90 degrees 
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ASCII files consist of an identification line, com- 
mands to represent the type and location of each 
object in the drawing, and a QUIT statement. The 
file components are described in the following 
sections. 


GED Files 


File Identification 
and End Statements 


Object Definitions 


Bodies 


name 


R angle 


pt ; 


paint color pt 


Each ASCII logic file starts with this line to identify 
the type of file to the system: 


FILE TYPE = MACRO_DRAWING; 
The file ends with the line: 


QUIT 


Each type of object in a GED drawing has a specific 
definition format. 


A body definition uses up to four lines in the ASCII 
file, in the following format: 


forceadd name 
[R angle] 

pt ; 

[paint co/or pt] 


The body name includes the version number. 


The rotation of the added body. The angle definition 
is optional. 


The placement point of the body. 


The optional paint command is included if the body 
is other than the default color. 


forceadd is used so that a place holder is created if 
the body is not found. 
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GED Files 


Wires 
linetype 
pattern 
pt? pt2 

Dots 

type 
pt 
paint co/or pt 
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A description of a wire in the ASCII file consists of 
a single line in the format: 


wire linetype pattern pt1 pt2 ; 


This numeric argument includes the line color and 
thickness definition. If the number is converted to 
binary, the least significant bit is the thin/heavy bit 
(0 = thin, 1 = heavy). The remaining seven bits 
specify the color. 


The fill pattern of the line. If pattern = -1, the line 
is filled. There are six defined wire patterns in 
GED: 


1 -1 4 2175 
2 273 3) 3135 
3 682 6 4383 


The begin and end points of the wire. 


Dots are described in the following format: 


dot type pt ; 
[paint co/or pt] 


If type = 0, the dot is open; if type = J, the dot is 
filled. If the type is not 0 or 1, the dot is assumed to 
be open. 


The location of the dot on the drawing. 


The optional paint command is included if the dot is 
other than the default color. 


GED Files 


Circles and Arcs 


pt 


paint color pt 


contents 
pt 
angle 


display size pt ; 


paint co/or pt 


Circles and arcs are described in the following 
format: 


circle pt7 pt2 ; 
[paint co/or pt] 


or 


circle pt? pt2 pt3 ; (for arcs) 
[paint co/or pt] 


Points are represented by the X-Y coordinates that 
describe a location on the drawing. 


The optional paint command is included if the circle 
or arc is other than the default color. 


The forcenote command is similar to the note 
command in the editor except that the forcenote 
command terminates after reading one note. Notes 
are described in the following format: 


forcenote contents pt angle; 
[display size pt ;] 
[paint co/or pt] 


The text of the note. 
The location of the note on the drawing. 
The rotation of the added note. 


This line is included if the note is not the default 
size. This command makes the text the correct size. 


The optional paint command is included if the note 
is other than the default color. 
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GED Files 


Properties 


default_status 


last 
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The forceprop command is similar to the property 
command except that it takes a default_status argu- 
ment. Property definitions occur directly after the 
object to which they are attached. The format is: 


forceprop default_status last name value 
[R angle} 

[J justification_type}] 

pt ; 

[display size pt 3] 

[paint color pt] 


This argument is necessary for the correct handling 
of changes to properties on library bodies. The 
default_status flag can have three values: 


0 The status of the property is unknown (an 
undefined variable whose status is deter- 
mined when the body definition is 
searched). 


1 The property is known to be default (one 
that comes from the body definition). 


2 The property is known to be non-default 
(one that a user added to the ASCII logic 
drawing). 


This argument indicates that the property is to be 
attached to the last object or wire entered. 


If the. property is a PIN property, the last argument 
is replaced by the lastpin argument followed by a pt 
that describes the location of the pin in absolute 
coordinates. 
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GED Files 


R angle 


J justification_type 


pt 
display size pt ; 


paint co/or pt 


Bubbled Pins 


A-10 


The rotation of the added property. The angle defi- 
nition is optional. | 


_| The justification of the added text. There are three 


possible values: 
0  ~=The text is left justified. 
1 The text is center justified. 
2 ~~=—s The text is right justified. 


If no justification is included, the property is created 
with the current default justification. If an illegal 
justification is given, the system uses left justifica- 
tion as the default. 


The location of the property on the drawing. 


If the property does not have the standard visibility, 
the display command sets the visibility of the name 
and value. 


The optional paint command is included if the note 
is other than the default color. 

Bubbled pins for an object are described in the 
format: 


forcebubble pt ... 


All pins that are not in their default bubbled state 
are listed. 
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GED Files 


Binary Files 


Body Files 


See the set command in the 
ValidGED Command Refer- 
ence Manual for more infor- 
mation on default spacing. 
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Binary files contain the same information as the 
ASCII file described, but in a binary format that is 
quicker to read and write. This format is proprietary 
and is not described in this document. 


Body files contain descriptions of bodies in ASCII 
format. Body files are written out in an abbreviated 
format; they are not tolerant of errors. Bodies are 
composed of seven elements: 


e Lines 

e Arcs 

e Text 

® Connections 

© Body properties 
e Pin properties 
e Bubble groups 


As in the ASCII files, GED internal coordinates are 
0.002 inches per unit by default. 
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GED Files; 


Line Definitions 


X71 yl x2 y2 


pattern 


color 


Arc Definitions 


xX y radius 


start_angle stop_angle 


color 
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Lines require one line each in the body file. A thin 
line has the format: 


L x7 y7 x2 y2 [ pattern] color 
A thick line has the format: 
M x7 y7 x2 y2 [ pattern] color 


The line’s endpoint coordinates; the line runs from 
(x1 yl) to (x2 y2). The coordinates are separated 
by spaces. 


This optional argument identifies the line style 
(solid, broken, etc.) as a bit pattern. For example, 
if pattern is -1, the line is solid and if pattern is 682, 
the line is dotted. See the pattern values listed with 
the description of wires in the ASCII file description. 


The internal GED color number. The line type de- 
scribes both the color and thickness of the line. 
When the integer is converted to a binary value, bit 
0 (zero) defines the thickness (0 = thin), and the 
seven most significant bits define the color. 


Arcs require one line each in the body file. The line 
has the format: 

A x y radius start_angle stop angle color 
The center and radius points of the arc. 


Floating point numbers that measure the angles, in 
degrees, counterclockwise from the X axis. 


The internal GED color number. 
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GED Files 


Text String Text strings require two lines each in the body file. 
Definitions The first line gives the specification of the text; the 
second gives the text string. The format is: 


T x y angle slant size over inv just font Nch color 


string 
xy The origin point for the text string. 
angle The angle of the text on the drawing. The allowed 
angles are: 
@ 0.00 e 180.00 
e 90.00 e 270.00 
size The height of the characters. 
- just The justification of the added text. There are three 


possible values: 
0 The text is left justified. 
1 The text is center justified. 
2 ~=s The text is right justified. 
Neh The number of characters and spaces in the string. 
color The internal GED color number. 


The text definition arguments s/ant, over, inv, and 
font are not currently implemented. 
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GED Files 


Connection 
Definitions 


Connections require one line each in the body file. 
The contents of the line depend on whether a pin 
can be bubbled or not. The format is: 


C x y “name” dispx dispy bubbleable [default_state x2 y2 x3 y3] f size angle just 


xy 


“name”’ 


Cispx dispy 


bubbleable 


default_state 


X2 y2 x3 y3 
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The location of the connection. 


The name of the connection. The name must be 
enclosed in quotation marks. 


The location of the name. 


Whether or not the pin is bubbleable. There are two 
possible values: 


0 False 
1 True 


Whether or not the pin is bubbled. There are two 
possible values: 


0 False 
1 True 


If the default_state is 1 when a body is initially 
added, the pin is bubbled. 


The endpoints of the bubbleable pin. These argu- 
ments are present only if the pin is bubbleable. 
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a 


GED Files 


size 


angle 


just 
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Whether the connection is a filled or open dot. 


0 Open 
1 Filled 
The size of the name string. The default is 41. 


The angle of the pin name string attached to the 
connection: 


0 0 degrees 

1 90 degrees 
2 180 degrees 
3 270 degrees 


The justification of the string. There are three 
possible values: 


L = The text is left—justified. 
C The text is center-justified. 


R_ ~The text is right-justified. 
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GED Files 


Body Property 
Definitions 


P “name 
““name”’ 
“value” 


xy 
angle 
‘size 


just 


NV 
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Body properties require one line each in the body 


file. The format is: 


value” x y angle slant size over inv just font NV VV IP color 


The name of the property. The name must be en- 
closed in quotation marks. 


The default value of the property. The value must 
be enclosed in quotation marks. 


The reference point for the property. 
The angle of the property. 
The height of the characters. 


The justification of the property. There are three 
possible values: 


0 = The text is left justified. 
1 The text is center justified. 
2 _~=s The text is right justified. 


The visibility of the property name. There are two 
possible values: 


0 The name is invisible. 
1 The name is visible. 


The name is visible by default. 
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GED Files 


VV 


IP 


color 


Pin Property 
Definitions 


Bubble Group 
Definitions 
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The visibility of the property value. There are two 
possible values: 


0 The value is invisible. 
1 The value is visible. 
The value is visible by default. 


Whether or not the property is a parameter. There 
are two possible values: 


0 False 
1 True 
The internal GED color number. 


The body property definition arguments s/ant, over, 
inv, and font are not currently implemented. 


) Pin properties require one line each. They are iden- 


tical to body properties except they start with an X, 
rather than a P, and occur directly after the connec- 
tion with which they are associated. 


Bubble groups require several lines each in the body 
file. They start with a line beginning with B and end 
with a line containing only the word END. Each 
bubble group is on a line by itself, with the format: 


33 66 99 66 


[“name?1”, “name2”’,“‘name3’’,...] 


All the names are quoted strings. If the bubble 
group is asymmetrical, the first comma is replaced 
by a colon. 
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GED Files 


Connectivity 
Files 
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Connectivity files describe all the bodies on a draw- 
ing. The information includes: 


e The names of the bodies 


e The names of the signals tied to their pins 
(with bubble state) 


e The properties that belong to the body 


Connectivity files, which are in ASCII format, are 
the only files used by the Compiler. 


There are four types of items in a connectivity file: 
e The header 
e Comments 
e The NET section 
e INVOKE commands 
Each connectivity file has the form: 


FILE_ TYPE = CONNECTIVITY; 
{GED_Release: date and number} 
[expression property] 

[nets] 

[invokes] 

END. 


The first line is the header, the second line is a com- 
ment, the third is the expression property from the 
drawing body, the fourth line begins the net section, 
the fifth line begins the invoke command section, 
and the sixth is the END statement. The expression 
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GED Files 


Comments 


Expression Property 
on a Drawing Body 
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property, net, and invoke sections are optional. The 
continuation character for lines in a connectivity file 
is a tilde (-). This character can occur anywhere in 
the line, even in the middle of words, but must be 
followed by <LF>. 


Comments begin with an open brace ({) and end 
with a close brace (}). They can appear anywhere in 
a connectivity file except in the middle of identifiers 
or quoted strings and can cross lines. 


The expression string is the expression property 
value from the drawing body. The format of the 
expression string is : 


expr property ::= EXPR = expression string; 


EXPR="SIZE=10"; 
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GED Files 


Nets 


constant 


“net_name_string” 


property_list 


identifier 


“string” 
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Each time GED writes a connectivity file, it numbers 
all the nets. The NC net is always net zero. Un- 
named signals are also numbered. The net numbers 
are not the same each time the connectivity file is 
written. The format is: 


nets ::= constant “net_name_string” [property_list]; 


The net number. 


Either the signal name for the net or the unnamed 
signal string created by GED. The net_name_string 
must be enclosed in quotation marks. 


An optional argument, the property _list has the 
format: 


property _list ::= {identifier string} 


The property name. The name must begin with a 
letter and can contain only: 


e Letters 
e Digits 
e Underscore (_) | 


There are two reserved identifiers: FILE_TYPE and 
END. 


The quoted string. 


Two sample net entries follow. 


2"UN$1$2P$A"; 


3"ANWC"LOAD"37"CONNECTED_ TO"PAGE 4"; 
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in 


GED Files 


Invoking 
Components 


“invoke_name_string”’ 


“version_str” 


xy_str 


“rotation” 
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Each component in the drawing is described as fol- 
lows in the connectivity file: 


invokes ::= 
% “invoke_name_string” 
“version_str’ ,xy_str,“rotation” ,directory_s tr,path_s tr; 
[ parameter_property_list ] ; 
[ property list ] ; 
~ {“pin_name_string” [property_list] constant; } 


The name of the component. The string must be 
enclosed in quotation marks. 


The body version number; the string must be en- 
closed in quotation marks. This property is always 
output. If this property doesn’t exist, the null string 
(“ ”) is used. 


The coordinates of the body on the page. This prop- 
erty is always output. If this property doesn’t exist, 
the null string (“ ”) is used. 


The rotation of the body; the string must be en- 
closed in quotation marks. This property is always 
output; if it doesn’t exist, the null string (“ ”) is 
used. rotation can be one of the following values: 


0 degrees rotation 

90 degrees rotation 
Mirror of 0 degrees 
Mirror of 90 degrees 
180 degree rotation 
270 degree rotation 
Mirror of 180 degrees 
Mirror of 90 degrees 
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GED Files 


parameter_property_list 


directory_str 


path_str 


property _list ; 


““pin_name_string” 
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EXAMPLES f 


constant 


The name of the directory or library where the body 
originated, for example, Isttl.lib. The full pathname 
or file specification is not required. If this property 
doesn’t exist, the null string (“ ”) is used. 


The path property. If this property doesn’t exist, the 
null string (“ ”) is used. 


An optional list with the same format as a property 
list. 


The property_list is optional; the semicolon is 
required. 


The pin name string must be enclosed in quotation 
marks. | 


The number of the net that is attached to the 
pin_name_string. The net numbers are assigned in 
the net section. 


% "LSOO" {body name} 
"1","(100,345)", "0", "1sttl.lib","2P"; {body info} 
SIZE"SIZE"; {parameter property list} 
COLOR" RED" SECTION"U32"; {body property list} 
"A"23; {pin names} 
MBs : 


"Y"OUTPUT_LOAD" (50.0,-50.0) "3; 


% “LSO2" {body name} 
"2","(500,1234)","3","1sttl.1ib",""; {body info} 
: {parameter property list} 
COLOR" RED"; {body property list} 
"ANO3; {pin names} 
"B"5; 


"Y"OQUTPUT_LOAD" (50.0,-50.0) "3; 
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GED Files 


Dependency 
Files 


SCALDsystem and PC AT: 


Sun Workstation: 
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Dependency files list the operating system filenames 
for each body added to a drawing. These files are 
used by the GED update procedure, which allows 
drawings to be updated if any bodies are out of date. 
There are dependency files for all drawings except 
BODY and DOC drawings. 


The first line of a dependency file is the drawing’s 
logic file name, a colon (:), and a list of body file 
names separated by blanks. The names are all com- 
plete UNIX pathnames or full VMS file 
specifications. 


For example, a sample dependency file for the logic 


‘drawing MY EXAMPLE.LOGIC.1.1 is: 


myexample/logic.1.1: \ 
/u0/lib/IsttI/ls00/body.1.1: \ 
/u0/lib/isttl/Is03/body.1.1 \ 
adder/body.1.1 \ 
shifter/body.1.1 


myexample/logic.1.1: \ 
/usr/valid/tools/lib/stti/Is00/body.1.1: \ 
/usr/valid/tools/lib/Isttl/Is03/body.1.1 \ 
adder/body.1.1 \ 
shifter/body.1.1 


The \ (followed by a (Return) is used to continue 


across lines. Subsequent lines begin with a 


(tab _}. Files are referenced from the UNIX direc- 
tory containing the SCALD directory file that holds 
the logic drawing. For example, from the directory 
/u0/class, you need to enter only shifter/logic.1.1. 
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VAX Workstation: 


SCALDsystem and PC AT: 
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Sun Workstation: 


VAX Workstation: 


However, parts that are added from SCALD directo- 
ries not in the current UNIX directory are given a 
full file specification name. The entire path name 
must be written out; no wildcards are allowed. 


[.MYEXAMPLE]LOGIC$1$1.DAT: \ 
SCALD$ROOT: [LIBRARIES.LSTTL.LSO00]BODY$1$1.DAT 
SCALD$ROOT: [LIBRARIES.LSTTL.LS03] BODY$1$1.DAT 
[.ADDER]BODY$1$1.DAT \ 
[.SHIFTER] BODY$1$1.DAT 


The \ (followed by a (Return) is used to continue 
across lines. Subsequent lines begin with a 
Ctap J). Files are referenced from the VMS direc- 
tory containing the SCALD directory file that holds 
the logic drawing. For example, from the directory 
SCALD$ROOT[CLASS], you need to enter only 
[.SHIFTER]LOGIC$1$1.DAT. However, parts that 
are added from SCALD directories not in the cur- 
rent VMS directory are given a full file specification 
name. The entire path name must be written out; 
no wildcards are allowed. 


Pa a 


The last line in the dependency file is: 
/u0/editor/MakeAddToList 
“drawing_name.extension.version.page”’ 
/usr/valid/tools/editor/MakeAddToList 
“drawing_name.extension.version.page” 
SCALD$ROOT:[EDITOR]MAKEADDTOLIST 
“drawing_name.extension.version.page” 


The drawing_name is quoted, and all parts of the 
name (extension, version, and page) must be 
specified. | 


1/15/89 


a 


GED Files 


Back Annotation 
File 
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This section discusses the format for the file read by 
the Graphics Editor’s backannotate command and 
generated by the Packager. If you do not use the 
back annotation file generated by the Packager, 
there is no guarantee that the annotated information 
is consistent with the physical design. 


The back annotation file contains physical informa- 
tion grouped by drawing. The back annotation file 
is named pstback.dat by the Packager. 


The first line is of the file is: 
FILE TYPE = BACK_ANNOTATION; 
The last line in the file is: 
END. 
The information in the file includes: 
° Drawing name e Pin names 
© Body names ® Net names 


The back annotation file should not contain informa- 
tion for bodies with SIZE and/or TIMES properties 
except as follows: 


e A LOCATION property for the body should 
be output only if all SIZE-replicated logical 
sections of the body are allocated to the same 
physical part. 


e Pin numbers for pins of SIZE-replicated 
components should be output only if the pin 
is common to all sections and appears on the 
same pin for all. 
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Drawing Names The drawing name line has the following syntax: 


DRAWING = “SCALD dwg_name.extension.version.page” ; 


The drawing name must be enclosed in quotation 
marks. 


Body Names Body names are specified by giving the body’s name 
and path property and any information to be at- 
tached to the body. If there is no information to be 
attached, the line is: 


BODY = “name’’,“path_property”’; 


If properties are to be attached, the statement ends 
with a colon and is followed by property name/value 
pairs, separated by commas. 


Property values are enclosed in quotation marks, but 
not property names. 


There MUST be spaces around any equal sign (=). 


Pin Names Pin names include the name of a pin on the body as 
well as any information to be attached to the pin. 
Vectored pins cannot be annotated. The pin name is 
enclosed in quotes. For instance: 


PIN = “pin_name”: prop? = “value1”, ... propN = “valueN”; 


Property names must be 15 characters or less. Prop- 
erty values are enclosed in quotes, but not property 
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names. There MUST be spaces around any equal 
sign (=). The only information given should be the 
pin number (PN property). If a pin does not have 
any properties, the pin should not be listed. 


Net Names Net names include the name of a net, in user syntax 
form, and any information attached to the net. Both 
scalar and vectored nets can be annotated. The 


form is: 
NET = “net_name”: prop? = “value1”, .... propN = “valueN”; 
Sample Back FILE_TYPE = BACK_ANNOTATION; 


DRAWING = "C C.LOGIC.1.1"; 

BODY = "LS74","6P"; LOCATION = "U32"; 
"CLOCK*"; PN = "1"; — 

"Dp"; PN = "gu. 

BODY = "LSO8","5P"; LOCATION = "U34"; 
"Y<0>": PN = "1"; 

NET = "XOUT": PNN=GLOBALXOUT 

DRAWING = "C C 2.LOGIC.1.1"; 

BODY = "LS74","6P":; LOCATION = "U34"; 
"CLOCK*"; PN = "3"; 

"D"; PN = "Qt. 

BODY = "LSO8","5P"; LOCATION = "U32"; 
"Y<QO>": PN = ws 

NET = "XOUT": S$XRF=4A5 

END. 


Annotation File 
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Vector Plot 
Format 


Line Primitive 


X71 y1 x2 y2 


pattern 


color 
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This section describes the format of the plot file pro- 
duced with GED’s vectorize command. This com- 
mand produces an ASCII plot file that can be used 
to transmit drawings to other machines or that can 
be used to drive a pen plotter (with the aid of a for- 
mat conversion program). 


The vector output is a plot of the entire drawing, not 
just the portion showing on the screen. 


There are three different types of primitives in the 
plot file: LINES, ARCS, and TEXT_STRINGS. The 
first character of the line specifies the type of the 
primitive. All units are nominally 0.002 inches. 


Lines require one line each in the file. The format 
is: 


L x7 y7 x2 y2 [pattern] color 


The line’s endpoint coordinates; the line runs from 
(x1 y1) to (x2 y2). The coordinates are separated 
by spaces. 


This optional argument identifies the line style 

(solid, broken, etc.) as a bit pattern. For example, 
if pattern is -1, the line is solid and if pattern is 682, 
the line is dotted. See the pattern values listed with 
the description of wires in the ASCII file description. 


The internal GED color number. The line type de- 
scribes both the color and thickness of the line. 
When the integer is converted to a binary value, bit 
zero defines the thickness (0 = thin), and the seven 
most significant bits define the color. 
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Arc Primitive 


xX y radius 


start_angle stop_angle 


Text String Primitive 


xy 
angle 


justification 


string 
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The format of the arc primitive is: 
A x y radius start_angle stop_angle 
The center and radius points of the arc. 


Floating point numbers that measure the angles, in 
degrees, counterclockwise from the X axis. 


Each text string primitive consists of the following 
four lines; each line is terminated by a line feed 
character. 


Txy 

angle slant size overbar inverse_video 
justification font 

string 


The origin point of the text string. 


The angle of the text on the drawing. The allowed 
angles are: 


@ 0.00 e 180.00 
e 90.00 e 270.00 


The justification of the added text. There are thee 
possible values: 


0 = The text is left justified. 
1 The text is center justified. 
2 «The text is right justified. 
The text string. No quotation marks are required. 


The text definition arguments s/ant, overbar, 
inverse_video, and font are not currently imple- 
mented. 
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If supported on your system, refer to the source in 
the following file for an example of how to convert 
the Valid Vector Plot Format to the HPGL (Hewlett 
Packard Graphics Language) format for display on 
an HP pen plotter. 


SCALDsystem or PC AT /u0/editor/lib/hpfilter.c 
Sun Workstation /usr/valid/tools/editor/lib/hpfilter.c 


This program is run by the hardcopy command 
when you have set mono_hpplot. 
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de section identifies the fonts supported by GED: 


vector_font 
valid_font 
milspec_font 
gothic_font 
cursive_font 
symbol_font 
greek_font 


native_font 


Fonts 
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The font name in parentheses is the font_name argu- 
ment for the font option of the set command 
(set font font_name). 


To use these fonts on a drawing, issue the set com- 
mand to specify the required font and then 
hardcopy your drawing. Only one font style can be 
active at any time, and the active font affects all 
drawings plotted while it is active. 


Native Font uses a font that is built into the plotter 
where applicable. 
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Figure B-4. Valid Font ASCII Codes 
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Figure B-12. Symbol Font ASCII Codes 
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Figure B-14. Greek Font ASCII Codes 
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Batch and 
Non-Graphical GED 


This section explains: 
e NGED (Non-graphical GED) 


e Redirecting GED input and output 
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NGED Graphical GED: 
e Only runs on graphics workstations 
e Always draws graphics on the screen 
e Only runs in the background under Suntools 


NGED allows the editor to run in a non-graphical 
mode. This allows you to run GED: 


e Without a graphics terminal 
e In the background 


This is useful for running a large batch process, 
such as hardcopy or backannotate, without having 
to enter GED. 


To run nongraphical GED, type the command: 
nged drawing_name 


Like the ged command, this command accepts an 
initial drawing name as a command line argument. 
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Redirecting GED | GED’s input and output can be redirected to or from 
a file. You can choose to redirect either or both the 


Input and Output input and output. If GED or NGED reads from a 
file, it operates about the same as when reading a 
file with the script command. If GED or NGED 
writes to a file, it stores the text messages that are 
also printed on the screen. 


In UNIX, use one of the following commands to re- 
direct the input and/or output for GED or NGED: 


ged < input > output 
or 
nged < input > output 
input The file that contains the input commands. 
output The file that contains the output commands. 


In VMS, use the following command to read the in- 
put to GED from a file: 


DEFINE/USER_MODE GEDS$INPUT /NPUT.DAT 


INPUT.DAT is the name of the file that contains the 
input commands. GEDS$INPUT is a VMS logical 
name. 


To divert GED’s output into a file in VMS, type: 
DEFINE/USER_MODE GEDS$OUTPUT OUTPUT.DAT 


OUTPUT.DAT is the name of the file that contains 
the output commands. GEDS$OUTPUT is a VMS 
logical name. 
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To run GED in VMS batch mode, submit a DCL 
script (similar to the example in Figure C-1) to the 
batch queue. 


SET DEFAULT DRC9: [MYDIR.SUBDIR1.SUBDIR2] 
DEFINE/USER GED$INPUT GEDIN.DAT 


DEFINE/USER GED$OUTPUT GEDOUT.DAT 
NGED 


Figure C-1. Sample DCL Script 


The following variables are used: 


e DRC9:[MYDIR.SUBDIR1.SUBDIR2] is the di- 
rectory where GED runs. 


e GEDIN.DAT is the input file to GED. 
e GEDOUT.DAT is the output file for GED. 
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Symbols 


; (semicolon) usage, 1-6 
* (asterisk) wildcard, 2-10 
\I signal propery, 4-21 


A 


ABBREV property, 3-26 


abbreviating 
commands, 1-2 
directory names, 2-5 
drawing names, 3-26 
SCALD directories, 2-11 


abnormal GED exit, 8-2 
accessing GED, 1-3 


add command, 2-16 to 2-17, 
3-5 to 3-6 
specifying drawing versions, 2-19 


adding 
bodies, 3-2 to 3-5 
borders, 3-26 
color, 3-30 
comments, 3-25 
date and time, 3-25 
dots, 3-17 to 3-18 
drawing name to hardcopies, 3-26 
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index 


adding (continued) 
drawings to text files, 7-2 to 7-4 
NOT bodies, 3-19 to 3-20 
notes, 3-25 
objects to defined groups, 3-28 
properties, 3-20 to 3-24 
signal names, 3-13 to 3-14 
wire segments, 3-44 


angle representation in ASCII files, A-5 


annotating drawings, 3-25 
arc 
definitions, A-—12 
primitive, A-29 


arc command, 4-23 


arcs 
drawing, 3-24 
vertices, 3-4 

ASCII files, A-5 to A-10 
drawing, 2-9 
plotting, 5-8 

assertion 


level, 3-12 
signal, 3-19 


assign command, 1-9 


assigning 
colors, 3-31 
physical parts, 6-6 


Index 


assignments 
default function key, A-2 
manual, overriding, 6-6 


asterisk (*) wildcard, 2-10 
attaching 
properties, 3-20 
wires, 3-7 
attachments 
verifying, 4-22 
vertex, 1-14 
auto command 
dots, 3-18 
undot, 3-18 


automatic wiring, 3-10 


back annotation 

file, 6-4, A-25 to A-27 

in structured designs, 4-14 
backann.cmd file, 6-5 


backannotate command, 6-2 
copying properties, 3-34 
file format, A-25 to A-27 
properties, 3-21, 6-4 
reattaching properties, 3-45 

batch processes, running, C-2 

beginning 
designs, 3-5 to 3-6 
drawings, 1-3 


bending wires, 3-7 


bent wires, see orthogonal wires 
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binary files 
drawing, 2-9 
plotting, 5-8 
bits, signal, 3-12 
blue cursor controller button, 3-7 


bodies 
adding, 3-2 to 3-5 
copying, 3-32 
creating, 3-5 to 3-7, 4-21 to 4-25 
hierarchical, 2-18 
incompatible, 3-2 
mirroring, 3-7 
positioning, 3-7 
rotating, 3-7 
versioning, 4-24 


body 
DEFINE, 3-20 
definition in ASCII files, A-6 
DRAWING 
attaching properties, 3-20 
last update, 3-25 
files, A-11 to A~17 
names in back annotation file, A~26 
NOT, 3-19 to 3-20 
origin, 4-21 
PAGE, 3-26 
properties, 3-22 
property definitions, A-16 
rotating, 2 
versioning, 2 
versions, 2-18 to 2-19, 3-6 
vertex, 4-21 
vertices, 3-3, 3-4 


BODY drawings, 2-18, 4-19 
bordering drawings, 3-26 
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index 


borrowing drawings, 2-13 to 2-15 changing 
SCALD directory storage, 2-22 default drawing type, 4-4 to 4-5 
defaults, 3-37 
boxes, free, 1-6 system editor, 3-41 
bubble checking, 3-19 san 3-2 
= types, 3-2 
bubble command, 3-6 views, 6 AT O54 
bubbled pins, 3-24 existing documents, 7-7 
defining, 4-23, A-10 groups, 3-41 
pin states, 3-6 
bus SCALD directories, 2-11 
name syntax, 3-15 system defaults, A-2 
notation, 4-8 text strings, 3-39 


wiring directions, 1-14 


bus-through pins, 3-11 check command, 3-55 to 3-56 


busname command, 3-13, checking 
3-15 to 3-17 connections, 3-19 
wiring, 3-48 


buttons, cursor controller, 1-13 circle command, 3-24 


defining bubbled pins, 4-23 
in ASCII files, A-8 


C circles 
drawing, 3-24 
case.dat file, 2-4 vertices, 3-4 
ee colors, drawing, 3-30 
case-Sensitivity 
command 
GED, 1-2 sian 
abbreviations, 1-2 
UNIX, 5 : 
conventions, 1-2 
change command, 3-39 files, 2-2 to 2-3 
options, Zoom command, 1-11 
changes © commands 
discarding, 1-4, 2-21 interpreting, 1-13 
global, 3-41 issuing, 1-2 
making, 3-37 to 3-46 selecting, 1-13 
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Index 


comments 
in connectivity files, A-19 
in drawings, 3-25 
compatibility, directory, 3-2 
compiler 


bubble checking, 3-19 

interpreting signals, 3-12 
compiler.cmd file, 2-2 

editing, 2-25 
component libraries, 2 
components 

adding, 3-5 

invoking, A-21 
config.dat file, 3-15, A-3 
connections 

bus-through pins, 3-11 

checking, 3-19 

defining, A-14 

showing, 3-18 

wire, 3-17 
connectivity 

defining, 3-12 

drawing file, 2-9 

files, 3-12, 7-2, A-18 to A-22 
controller, cursor, 1-13 to 1-15 
controlling signal interpretation, 3-12 


conventions 
command, 1-2 
drawing name, 2-16 


copy command, 3-32 to 3-36 
copying objects, 3-32 to 3-36 
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correcting mistakes, 3-37 
crash recovery, 8-2 


creating 
bodies, 3-5 to 3~7, 4-21 to 4-25 
different versions, 4-24 
documents, 7-5 
flat designs, 4-3 
hierarchical designs, 4-17 
plot files, 5-5 to 5-6 
project directories, 2-24 
SCALD directories, 2-7 
scripts, 3-57 to 3-58 
search stacks, 2-11 to 2-13 
structured designs, 4-7 


cursor controller, 1-6, 1-13 to 1-15 
buttons, 3-7 


customizing GED, 3-37 
cut command, 3-35 


D 


data files, 2-3. to 2-4 
dating drawings, 3-25 


default 

abbreviations file, 2-11 
body properties, 3-45 
colors, establishing, 3-30 
command files, 2-2 to 2-3 
data files, 2-3 to 2-4 
drawing 

name entry, 2-16 

type, changing, 4-4 to 4-5 
files, 2-2 to 2-6 
function keys, 1-10, A~2 
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default (continued) 
grid setting, 1-8, 4-21 
page length, 7-2 
pin number size, 6-5 
properties, 3-34 
system editor, 3-41 
text size, increasing, 3-38 
wiring mode, 3-8 


default_status flag, A~9 
defaults, changing, 3-37 
DEFINE body, 3-20 


defining 
bubbled pins, 4-23 
connectivity, 3-12 
GED environment, 2-5 
groups, 3-27 to 3-29, 3-41 
library parts, 2-18 
low asserted pins, 4-23 to 4-24 
signal names, 3-12 


definitions 
arc, A-12 
body, A-6 
body property, A-16 
bubbled pin, A-10 
connection, A-14 
dot, A-7 
line, A-12 
property, A-9 
text string, A-13 
wire, A-7 


delete command, 3-46 
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deleting 
drawings, 2-22 
objects and groups, 3-46 
properties, 3-46 


dependency files, 8-4, A-23 to A-24 
drawing, 2-9 


describing signals, 3-12 


design 
elements, vertices of, 3-4 
techniques, 4-2 


designs 
beginning, 3-5 to 3-6 
creating 
flat, 4-3 
hierarchical, 4-17 
structured, 4~7 
flat, 4-2 to 4-6 
hierarchical, 4-17 to 4-27 
processing, 6-3 
saving, 2-22 
structured, 4-7 to 4-16 


diagonal wires, see direct wires 
diagram command, 2-22, 3-2 
direct wires, 2, 3-7 

directions, wiring, changing, 1-14 


directories 
creating, 2-24 
drawing, 2-8 
listing, 2-10 
LOGIC, 2-8 


Index 


directories (continued) 

SCALD, 2-2, 2-4 
abbreviations, 2-11 
changing, 2-11 
creating, 2-7 
extensions, 2-7 
name mapping, 2-8 
naming, 2-7 
restore.wrk, 8-2 
searching, 2-11 to 2-13 
specifying, 3-5 


directory 
compatibility, 3-2 
names, abbreviating, 2-5 
types, 2-8 
working, 1-6 


directory command, 2-10 
discarding drawing changes, 1-4, 2-21 


display command, 3-37 
in ASCII files, A~8 to A-10 
options, 3-23 


displaying 
grids, 1-8, 3-38 
line patterns, A-7 
part versions, 3-6 
pin numbers, 6-5 
properties, 3-23 


DOC drawings, 7-2 
document tick marks, 7-9 


documentation conventions, 5 


I-6 


documents 
changing, 7-7 
creating, 7-5 
printing, 7-9 
dot command, 3-37 
in ASCII files, A-7 
in body drawings, 4-22 


marking connections, 3-17 to 3-18 


dots 
adding, 3-17 to 3-18 
defining, A-7 
filled, 3-18 
removing, 3-18 
vertices, 3-4 


dragging, dynamic, 2 


drawing 

arcs, 3-24 

BODY, 4-19 

changes, discarding, 2-21 

circles, 3-24 

directory, 2-8 

files, 2-9 

LOGIC, 4-19 

names, 2-16 to 2-20 
abbreviating, 3-26 
changing, 3-2 


in back annotation file, A-26 
multiple page drawings, 4-5 
printing on hardcopy, 3-26 


spaces in, 1~3 

special characters, 1-3 
pages, 2-20, 4-3 

deleting, 2-22 
restrictions, 3-2 
sizes, 3-47 
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Index 


drawing (continued) drawings (continued) 
types starting, 1-3 
BODY, 2-18 storing, 2-4 
changing, 3-2, 4-4 to 4-5 temporary, 8-2 
identifying, 2-17 to 2-18 time-stamping, 3-25 
LOGIC, 2-18 updating, 8-4 
versions, 2-18 to 2-19 viewing, 3-47 to 3-54 
deleting, 2-22 duplicating objects, 3-32 to 3-36 
sizeable, 2-19 ; ; 
wires, 3-7 dynamic dragging, 2, 3-42 
DRAWING body, 3-20, 3-25 Ee 
drawings ; 
sailing to text files, 7-2 to 7-4 edit command, 1-3, 3-37 
bordering, 3-26 beginning drawings, 3-5 
borrowing, 2-13 to 2-15, 2-22 borrowing drawings, 2-14 


creating body versions, 4-24 
selecting drawing pages, 2-20 
specifying drawings, 2-21 


changing, 3-37 
coloring, 3-30 
dating, 3-25 


deleting, 2-22 using drawing types, 2-17 

discarding changes, 1-4 editing 

boc, 7-2 compiler.cmd files, 2-25 

editing, 2-21, 3-37 drawings, 2-21, 3-37 
multiple drawings, 2-21 existing documents, 7-7 

enlarging details, 3-48 to 3-50 multiple drawings, 2-21 

locating, 2-7 Startup.ged file, 2-24 

multiple page, 3-12, 4-5 td.cmd, 2-25 

panning, 3-47 to 3-48 text, 3-39 

plotting, 5-2 to 5-13 editors, 3-39 

reducing, 3-51 default, 3-41 


removing objects and text from, 3-46 


renaming, 2-22 EDT editor, 3-41 


restoring, 8-2 ending wires, 3-8 

saving, 1-4, 2-22 enlarging 

scaling, 3-53 drawing details, 3-48 to 3-50 
specifying, 2-21 text, 1-16 
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error command, 3-55 to 3-56 
establishing default colors, 3-30 
exclude command, 3-28 

exit command, 1-4 

exiting GED, 1-4 

expression property, A-19 
expressions, select, 2-19 
extensions, SCALD directory, 2-7 


F 


fields, drawing name, 2-17 to 2-20 
file 
header format, harcopy, 5-8 to 5-10 
types, 2-2 


filenote command, 3-25, 7-5 


files 
abbreviations, 2-11 
ASCII, A-5 to A-10 
plotting, 5-8 
back annotation, 6-4, A-25 to A-27 
backann.cmd, 6-5 
binary, A-11 
plotting, 5-8 
body, A-11 to A-17 
case.dat,. 2-4 
command, 2-2 to 2-3 
compiler.cmd, 2-2 
editing, 2-25 
config.dat, 3-15, A-3 
connectivity, 3-12, 7-2, 
A-18 to A-22 


files (continued) 
data, 2-3 to 2-4 
default, 2-2 to 2-6 
dependency, 8-4, A-23 to A-24 
drawing, 2-9 
master.lib, A-4 
master.local, 2-3, 2-5 to 2-6 
in SCALD directories, 2-11 
packager.cmd, 2-3 
plot, 5-5 to 5-6 
pstback.dat, 6-4, A-25 
recovering, 8-2 
simulate.cmd, 2-3 
softkeyassign, A-3 
startup.ged, 2-2 
accessing libraries, 3-5 
changing default values, 3-37 
editing, 2-24 
restrictions, 2-5 
search stacks, 2-11 to 2-13 
system-wide, A-2 
startup.valid, A-2 
system initialization, A-2 to A-4 
td.cmd, 2-3 - 
editing, 2-25 
temporary, 8-2 
text, 7-2 
adding drawings to, 7-2 to 7-4 
verifier.cmd, 2-3 
vw.spool, 5-5 


filled dots, 3-18 

find command, 3-28, 3-41 
fitting drawings to windows, 3-54 
flag, default_status, A-9 

flat designs, 4-2 to 4-6 
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flattener, schematic, 4-2, 4-16, 4-27 


font styles, 7-9, B-1 to B-16 
forceadd command, A-6 
forcebubble command, A-10 
forcenote command, A-8 
forceprop command, A-9 
format command, 7-2 


formats 
hardcopy header, 5-8 to 5-10 
vector plot, A-28 to A-30 


free menu boxes, 1-6 


function keys, 1-9 
default, 1-10, A-2 
shifted, 1-11 
softkeyassign file, A-3 


G 


GED 
accessing, 1-3 
case-sensitivity, 1-2 
command conventions, 1-2 
customizing, 3-37 
defining the environment, 2-5 
exiting, 1-4 
interpreting commands, 1-13 
non-graphical, C-2 
redirecting input/output, C-3 
screen display, /-5 
starting, 1-3 
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Index 


ged command, 1-3 


GED commands 
add, 2-16 to 2-17, 3-5 to 3-6 
specifying drawing versions, 2-19 
arc, 4-23 
assign, 1-9 
auto 
dots, 3-18 
undot, 3-18 
backannotate, 6-2 
copying properties, 3-34 
file format, A-25 to A-27 
properties, 3-21, 6-4 
reattaching properties, 3-45 
bubble, 3-6 
busname, 3-13, 3-15 to 3-17 
change, 3-39 
check, 3-55 to 3-56 
circle, 3-24 
defining bubbled pins, 4-23 
in ASCII files, A-8 
copy, 3-32 to 3-36 
cut, 3-35 
delete, 3-46 
diagram, 2-22, 3-2 
directory, 2-10 
display, 3-37 
in ASCII files, A-8 to A-10 
options, 3-23 
dot, 3-37 
in ASCII files, A-7 
in body drawings, 4-22 
marking connections, 3-17 to 3-18 


Index 


GED commands (continued) 

edit, 1-3, 3-37 
beginning drawings, 3-5 
borrowing drawings, 2-14 
creating body versions, 4-24 
selecting drawing pages, 2-20 
specifying drawings, 2-21 
using drawing types, 2-17 

error, 3-55 to 3-56 

exclude, 3-28 

exit, 1-4 

filenote, 3-25, 7-5 

find, 3-28, 3-41 

forceadd, A-6 

forcebubble, A-10 

forcenote, A-8 

forceprop, A-9 

format, 7-2 

get, 2-17, 2-21 

grid, 1-8 

group, 3-27 

hardcopy, 5-2 to 5-13 
changing font styles, 7-9 
creating plot files, 5-5 
font styles, B-1 to B-16 
header file format, 5-8 to 5-10 
scale factor, 5-4 
vector plotting, A-30 

help, 1-16 

ignore, 2-13, 2-22 

include, 3-28 

library, 2-11, 2-24 
master.lib file, A-4 
specifying SCALD directories, 3-5 
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GED commands (continued) 


masterlibrary, 2-5, 2-25 
in startup.ged file, 2-11 
mirror, 3-7 
move, 3-42 to 3-43 
next, 3-41 
note, 3-25, 7-5 
labelling body drawings, 4-22 
paint, 3-30 to 3-31 
in ASCII files, A-6 to A-10 
paste, 3-35 
pinswap, 3-46 
copying properties, 3-34 
moving objects, 3-42 
properties, 3-21 
reattaching properties, 3-45 
property, 3-21 to 3-24 
attaching LOCATION property, 6-6 
quit, 1-4 
reattach, 3-45 
moving objects, 3-42 
redo, 3-37 
remove, 2-22 
replace, 2-17 
return, 2-21 
rotate, 3-7 
route, 3-10 
scale, 7-5 
script, 3-57 
section, 6-6 to 6-9 
copying properties, 3-34 
properties, 3-21 
reattaching properties, 3-45 
select, 3-27 
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Index 


GED commands (continued) GED commands (continued) 
set, 3-37 smash, 3-2 
changing wiring mode, 3-8 spin, 3-7 
check_on_write, 3-56 split, 3-44 
default_grid, 4-21 moving objects, 3-42 
defining default colors, 3-30 swap, 3-45 
dots filled, 3-18, 3-38 moving objects, 3-42 
far_pn, 6-5 undo, 3-37 
font, 7-9, B-2 use, 2-24, 3-5 
fractional, A-11 borrowing drawings, 2-14 
grid_on, 3-38 creating search stacks, 2-13 
local_plot, 5-3, 5-5 in SCALD directories, 2-7 
metric, A-11 specifying SCALD directories, 2-11 
mono_hpplot, A-30 vectorize, A-28 to A-30 
near_pn, 6-5 version, 2-19, 3-6 
pin_size, 6-5 window, 1-16, 3-47 to 3-54 
prop_display, 3-23 refresh, 3-18 
push_type, 2-17, 4-5 wire, 3-7 
rotate, 6-5 bus-—through pins, 3-11 
size, 3-38 defaults, 3-37 
spooled_plot, 5-5 in ASCII files, A-7 
user editor, 3-41 marking clock signals, 4-22 
show, 3-38 write, 1-4, 3-37 
attachments, 3-24, 4-22 borrowing drawings, 2-14 
color, 3-30 creating SCALD entries, 2-8 
connections, 3-18 saving drawings, 2-22 
history, 2-21 zoom, 3-47 to 3-54 
pins, 3-11 options, 1-11 
properties, 3-24 gedupdate command, 8-5 
vectors, eh 4-8 get command, 2-17, 2-21 
vertices, 3- : 
signame, 3-13 to 3-14 aoe arawing rans 3-41 
and signal properties, 3-22 graphics mixed with text, 7-2 
in body drawings, 4-22 green cursor controller button, 3-7 
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Index 


grid 
default setting, 4-21 
displaying, 1-8, 3-38 
intersections, 1-14 
interval, 1-8 
setting, 1-6 
default, 1-8 
size, 1-8 
spacing, 7-2 


grid command, 1-8 
group command, 3-27 
GROUP property, 6-6 


groups 
adding objects to, 3-28 
changing, 3-41 
copying, 3-32 
defining, 3-27 to 3-29, 3-41 
deleting, 3-46 
naming, 3-27 
operating on, 1-14 
removing objects from, 3-28 


H 


hard properties, 6-6 


hardcopy command, 5-2 to 5-13 
changing font styles, 7-9 
creating plot files, 5-5 
font styles, B-1 to B-16 
header file format, 5-8 to 5-10 
scale factor, 5-4 
vector plotting, A-30 


header file, hardcopy, 5-8 to 5-10 
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help command, 1-16 


hierarchical 
bodies, 2-18 
designs, 4-2, 4-17 to 4-27 


hopf command, 5-7 to 5-13 
HPGL format, A-30 


identifying 
drawing types, 2-17 to 2-18 
input signals, 3-12 


ignore command, 2-13, 2-22 
illegal drawing names, 2-17 
include command, 3-28 
incompatible bodies, 3-2 
increasing default text size, 3-38 
inherited properties, 3-22 


initialization files, system, A-2 to A-4 


input 

redirecting, C-3 

signals, identifying, 3-12 
interactive script operations, 3-57 
interface signal property (\I), 4-21 
interpreting 

commands, 1-13 

signals, 3-12 


intersection, grid, 1-14 
interval, grid, 1-8 

invoking components, A-21 
issuing commands, 1-2 
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K 


keyboard, 1-9 


keys, function, 1-9 
default, 1-10 
shifted, 1-11 


L 


LAST_MODIFIED property, 3-21 


libraries 
component, 2 
searching, 2-11 
Standard, 3-5, 4-13 to 4-14 
NOT body, 3-19 


library command, 2-11, 2-24 
master.lib file, A—4 
specifying SCALD directories, 3-5 

library parts, defining, 2-18 

line 
definitions, A-12 
editor, 3-39 

functions, 3-40 
patterns, A-7 
primitives, A-28 

listing directories, 2-10 

local_plot mode, 5-5 

locating 
drawings, 2-7 
text strings, 3-41 


LOCATION property, 6-6 
added by backannotate, 6-4 
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Index 


LOGIC drawings, 2-8, 2-18, 4-19 
logs, redo and undo, 3-37 
low asserted pins, 4-23 to 4-24 


M 


making 
changes, 3-37 to 3-46 
copies, 3-32 to 3-36 
global drawing changes, 3-41 


manual assignments, overriding, 6-6 
mapping SCALD directory names, 2-8 
marking wire connections, 3-17 
master.lib file, A-—4 


master.local file, 2-3, 2-5 to 2-6 
in SCALD directories, 2-11 


masterlibrary command, 2-5, 2-25 
in startup.ged file, 2-11 


menu, on-screen, 1-6 
message window, 1-7 
messages, program, 1-7 
mirror command, 3-7 
mistakes, correcting, 3-37 
mixing text and graphics, 7-2 
modes 
plotter, 5-5 
wiring, 3-7 
modifying existing documents, 7-7 


mouse, 1-6 
buttons, 1-13 


move command, 3-42 to 3-43 
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moving 
objects, 3-42 
using the split command, 3-44 
properties, 3-43 
windows, 3-47 to 3-48 
wires, 3-44 


multiple 
page drawings, 3-12 
flat designs, 4-3 
names, 4-5 
signals, 4-5 
use commands, 2-11 to 2-13 


N 


names 
body, in back annotation file, A-26 
drawing, 2-16 to 2-20 
changing, 3-2 
in back annotation file, A~26 
multiple page drawings, 4-5 
group, 3-27 
mapping in SCALD directories, 2-8 
net, A-27 
pin, A-26 
signal, 4-5 
translating, A-4 


naming 
SCALD directories, 2-7 
signals, 3-13 to 3-17 
shorthand, 3-15 to 3-17 


net names, A-27 
nets, A-20 
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next command, 3-41 
NGED, C-2 
non-graphical GED, C-2 
NOT body, 3-19 to 3-20 
notation, bus, 4-8 


note command, 3-25, 7-5 
labelling body drawings, 4-22 


notes 
adding to drawings, 2, 3-25 
editing, 3-39 
repositioning, 3-45 


O 


objects 
deleting, 3-46 
moving, 3-42 
using the split command, 3-44 
removing, 3-46 
selecting, 3-3 


on-line help, 1-16 

on-screen menu, 1-6 

open dots, 3-18 

Operations on groups, 1-14 
options, Zoom command, 1-11 
origin, body, 4-21 

orthogonal wires, 2, 3-7 
output, redirecting, C-3 


overriding manual assignments, 6-6 
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Index 


p 


Packager directives, 6-6 
packager.cmd file, 2-3 
PAGE body, 3-26 

page length, default, 7-2 


pages 
deleting, 2-22 
drawing, 4-3 

paging drawings, 2-20 


paint command, 3-30 to 3-31 
in ASCII files, A-6 to A-10 


panning drawings, 3-47 to 3-48 
part 

reference numbers, 6-2 

versions, displaying, 3-6 
parts 

library, defining, 2-18 

sizeable, 4-8 

Standard library, 4-13 
paste command, 3-35 
PATH property, 3-21, 3-34 
patterns, search, 3-42 


physical part assignments, 6-2, 6-4 
hard properties, 6-6 

pin 
definitions, bubbled, A-10 
names, A-26 
number displays, 6-5 
properties, 3-22, 3-34 
states, changing, 3-6 
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PIN_NAME property, 3-21 
pins 

bubbled, 3-24 

defining, 4-23 

bus-through, 3-11 

low asserted, 4-23 to 4-24 

showing, 3-11 

splitting wires from, 3-44 
pinswap command, 3-46 

copying properties, 3-34 

moving objects, 3-42 

properties, 3-21 

reattaching properties, 3-45 
plot 

files, 5-5 to 5-6 

format, vector, A-28 to A-30 
plotter type, hardcopy, 5-8 
PLOTTIME program, 2-3 
plotting 

ASCII and binary files, 5-8 

documents, 7-9 

drawings, 5-2 to 5-13 

font styles, B-1 to B-16 
positioning bodies, 3-7 
preset colors, 3-30 
primitives, 3-3 

arc, A-29 

incompatible, 3-2 

line, A-28 
printing 

documents, 7-9 

drawing name, 3-26 


processing designs, 6-3 


Index 


program messages, 1-7 
programmable function keys, 1-9 
project directories, creating, 2-24 
projects, specifying, 2-5 


properties, 2 
ABBREV, 3-26 
adding, 3-20 to 3-24 
attaching, 3-20 
backannotate command, 3-21, 6-4 
body, 3-22 
copying, 3-32 
default, 3-34, 3-45 
defining, A-9 
deleting, 3-46 
displaying, 3-23 
editing names and values, 3-39 
expression, on drawing bodies, A~19 
GROUP, 6-6 
hard, 6-6 
interface signal (\I), 4-21 
LAST_MODIFIED, 3-21 
LOCATION, 6-6 
added by backannotate, 6-4 
moving, 3-43 
PATH, 3-21, 3-34 
pin, 3-22, 3-34 
PIN_NAME, 3-21 
pinswap command, 3-21 
repositioning, 3-45 
SEC, 6-6 
section command, 3-21 
SIG_NAME, 3-12, 3-21 
signal, 3-12, 3-22 
SIZE, 4-2, 4-7 to 4-10 
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properties (continued) 
soft, 6-3 
syntax, 3-21 
TIMES, 4-11 to 4-13 
TITLE, 3-26 
wire, 3-34 


property command, 3-21 to 3-24 
attaching LOCATION property, 6-6 


pstback.dat file, 6-4, A-25 


puck, 1-6 
buttons, 1-13 


Q 


quit command, 1-4 


R 


real-time movement, 2 


reattach command, 3-45 
moving objects, 3-42 


recovering from system crashes, 8-2 
redirecting GED input/output, C-3 
redo command, 3-37 


reducing 
drawings, 3-51 
text, 3-52 


reference charts 

vertex, 3-4 

wiring, 3-9 
references, part number, 6-2 
refreshing the screen, 3-18 


remove command, 2-22 
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removing SCALD directories (continued) 
dots, 3-18 naming, 2-7 
drawing changes, 3-37 restore.wrk, 8-2 
drawings, 2-22 searching, 2-11 to 2-13 
objects from groups, 3-28 specifying, 3-5 
text and objects, 3-46 types, 2-8 

renaming drawings, 2-22 scale command, 7-5 


scale factor, hardcopy, 5-4 
scaling drawings, 3-53 
schematic flattener, 4-2, 4-16, 4-27 


replace command, 2-17 
repositioning notes or properties, 3-45 


restoring temporary drawings, 8-2 


screen 
restrictions display 
drawing, 3-2 changing, 3-47 to 3-54 
drawing names, 2-17 drawing size, 3-53 
return command, 2-21 GED, 1-5 
status line, 1-6 
reversing drawing changes, 3-37 refresh, 3-18 
rotate command, 3-7 script command, 3-57 
rotating bodies, 2, 3-7 scripts, creating, 3-57 to 3-58 
route command, 3-10 search stack, 2-22 
- creating, 2-11 to 2-13 
running batch processes, C-2 specifying drawings, 2-21 
searching 
S libraries, 2-11 
patterns, 3-41 to 3-42 
saving drawings, 1-4, 2-22, 8-2 SCALD directories, 2-11 to 2-13 
scalar signals, 3-12 text strings, 3-41 
SCALD directories, 2-2, 2-4 SEC property, 6-6 
abbreviations, ps | section command, 6-6 to 6-9 
changing, 2-11 copying properties, 3-34 
creating, 2-7 properties, 3-21 
extensions, 2-7 reattaching properties, 3-45 
name mapping, 2-8 select command, 3-27 
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select expressions, 2-19 


selecting 
commands, 1-13 
drawing pages, 2-20 
objects, 3-3 


semicolon (;) usage, 1-6 


set command, 3-37 
changing wiring mode, 3-8 
check_on_write, 3-56 
default_grid, 4-21 
defining default colors, 3-30 
dots filled, 3-18, 3-38 
far_pn, 6-5 
font, 7-9, B-2 
fractional, A-11 
grid_on, 3-38 
local_plot, 5-3, 5-5 
metric, A-11 
mono_hpplot, A-30 
near_pn, 6-5 
pin_size, 6-5 
prop display, 3-23 
push_type, 2-17, 4-5 
rotate, 6-5 
size, 3-38 
spooled_plot, 5-5 
user_editor, 3-41 


setting default colors, 3-30 


shifted function keys, 1-11 
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show command, 3-38 


attachments, 3-24, 4-22 
color, 3-30 
connections, 3-18 
history, 2-21 

pins, 3-11 

properties, 3-24 
vectors, 3-11, 4-8 
vertices, 3-3 


SIG_NAME property, 3-12, 3-21 
signal 


assertion, 3-12, 3-19 
bits, 3-12 
connections, checking, 3-19 
names 
defining, 3-12 
editing, 3-39 
multiple page drawings, 4-5 
shorthand, 3-15 to 3-17 
syntax, 3-15 to 3-17, A-3 
properties, 3-12, 3-22 
syntax, 3-12, 4-8 
vectored, 3-12 


signals 


controlling interpretation, 3-12 
describing characteristics, 3-12 
identifying, 3-12 

naming, 3-13 to 3-17 

scalar, 3-12 

unnamed, 3-34 


signame command, 3-13 to 3-14 


and signal properties, 3-22 
in body drawings, 4-22 
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simulate.cmd file, 2-3 

simulator primitives, 3-2 

single-page flat designs, creating, 4-3 
SIZE property, 4-2, 4-7 to 4-10 


sizeable 
drawing versions, 2-19 
parts, 4-8 


sizes, drawing, 3-47 

sizing text, 3-38 

smash command, 3-2 

soft properties, 6-3 
softkeyassign file, A-3 

spaces in drawing names, 1-3 


special characters 
asterisk (*), 2-10 
in drawing names, 1-3 
semicolon (;), 1-6 
specifying 
drawing pages, 2-20 
drawings, 2-21 
libraries, 2-5 
SCALD directories, 3-5 
abbreviations, 2-11 
search patterns, 3-42 


spin command, 3-7 


split command, 3-44 
moving objects, 3-42 


spooled_plot mode, 5-5 


standalone hardcopy (hpf command), 
5-7 to 5-13 
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Standard library, 3-5, 4-13 to 4-14 
NOT body, 3-19 


starting 
designs, 3-5 to 3-6 
drawings, 1-3 
GED, 1-3 
wires, 1-14, 3-7 


startup.ged file, 2-2 
accessing libraries, 3-5 
changing default values, 3-37 
editing, 2-24 
restrictions, 2-5 
search stacks, 2-11 to 2-13 
system-wide, A-2 
Startup.valid file, A-2 
status line, 1-6 
storing drawings, 2-4, 2-22 
structured designs, 4-2, 4-7 to 4-16 


swap command, 3-45 
moving objects, 3-42 
syntax 
bus name, 3-1/5 
drawing name, 2-16 
property, 3-21 
signal name, 3-12, 4-8, A-3 
standalone hardcopy, 5-7 to 5-13 
system 
crash recovery, 8-2 
editor, 3-39 
default, 3-41 
files 
config.dat, 3-15 
initialization, A-2 to A-4 
startup.ged, A-2 


Index 


T 


td.cmd file, 2-3 
editing, 2-25 


temporary drawings, 8-2 


text 
definitions, A-13 
deleting, 3-46 
editing, 3-39 
enlarging, 1-16 
files, 7-2 


adding drawings to, 7-2 to 7-4 


increasing default size, 3-38 
mixed with graphics, 7-2 
reducing, 3-52 

removing, 3-46 

searching strings, 3-41 
vertices, 3-3, 3-4 


tick marks on documents, 7-9 
time-stamping drawings, 3-25 
TIMES property, 4-11 to 4-13 
Timing Verifier, 2-3 
TITLE property, 3-26 


translations, name, A-4 


types 
directory, 2-8 
drawing 
BODY, 2-18 


changing, 3-2 
identifying, 2-17 to 2-18 
LOGIC, 2-18 
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U 


U-numbers, see part reference numbers 
unbubbled pins, defining, 4-23 
undo command, 3-37 


UNIX 
case-sensitivity, 5 
commands 

ged, 1-3 
gedupdate, 8-5 


unnamed signals, 3-34 
updating drawings, 8-4 


use command, 2-24, 3-5 
borrowing drawings, 2-14 
creating search stacks, 2-13 
in SCALD directories, 2-7 
specifying SCALD directories, 2-11 


user input tokens, 3-57 
using color, 3-30 


V 


ValidFLAT/Transcribe, 4-2, 4-16, 4-27 
vectored signals, 3-12 

vectorize command, A-28 to A-30 
vectors, showing, 3-11 

verifier.cmd file, 2-3 

verifying attachments, 4-22 

version command, 2-19, 3-6 


versioning, bodies, 2 
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versions 
body, 3-6 
creating, 4-24 
drawing, 2-18 to 2-19 
deleting, 2-22 
sizeable, 2-19 


vertex 
attaching to, 1-14 
body, 4-21 
reference chart, 3-4 


vertices, 3-3, 3-4 
vi editor, 3-41 
viewing drawings, 3-47 to 3-54 


vw.spool file, 5-5 


W 


white cursor controller button, 3-7 
wildcard characters, 2-10 


window command, 1-16, 3-47 to 3-54 
refresh, 3-18 


windows 
fitting drawings into, 3-54 
message, 1-7 
moving, 3-47 to 3-48 
wire 
definitions, A—7 
properties, 3-34 
vertices, 3-3, 3-4 
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wire command, 3-7 
bus-through pins, 3-11 
defaults, 3-37 
in ASCII files, A-7 
marking clock signals, 4-22 


wires 
attaching, 3-7 
bending, 3-7 
copying, 3-32 
direct, 2 
line patterns, A-7 
moving, 3-44 
orthogonal, 2 
splitting from pins, 3-44 
starting, 1-14, 3-7 
wiring 
adding segments, 3-44 
automatically, 3-10 
blue button, 3-7 
bus-through pins, 3-11 
changing directions, 1-14 
checking, 3-48 
diagonal mode, 3-7 
ending wires, 3-8 
marking connections, 3-17 
orthogonal mode, 3-7 
reference chart, 3-9 
white button, 3-7 
yellow button, 3-7 


working directory, 1-6 


write command, 1-4, 3-37 
borrowing drawings, 2-14 
creating SCALD entries, 2-8 
saving drawings, 2-22 
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Y 


yellow cursor controller button, 3-7 
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Z 


zoom command, 3-47 to 3-54 
options, 1-11 
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Preface 


The ValidGED Command Reference Guide contains an 
alphabetical listing of GED commands. You can enter 


GED commands in several ways: 


e Type the command in the message window 


and press (Return). 


e Use the cursor controller to select the com- 
mand from the on-screen menu. 


e In some cases, press a pre-defined function 
key. 
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Preface 


Command Entry Whether you use the keyboard, menus, or buttons to 
enter a command, every command and its argu- 


ments are echoed within the message window. 


GED is not case-sensitive; it recognizes commands 
typed in either uppercase or lowercase letters. How- 
ever, file names and text added to drawings are 
case-sensitive. 


Command The minimum entry for each command is underlined 


Abbreviations in the command syntax line. Typing either the full 
name or the abbreviation executes the same 
command. 


command 


directory 
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Command Syntax 


SYNTAX 


operands 


points 


EXAMPLE § 
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Commands that require arguments and optional en- 
tries follow the general syntax shown below. 


command [operands...] [ points... ] ... 


Variable arguments for each command are ex- 
plained below the syntax line. You must substitute 
the appropriate value for the command argument(s) 


| when you enter the command. The description of 


the argument provides potential values for the argu- 
ment. Square brackets surrounding any operand in- 
dicate the argument is optional. You do not type the 
Square brackets. 


Any points required by the command can be entered 
by pressing the appropriate cursor controller (mouse 
or puck) button or by typing the coordinates at the 
keyboard. Coordinates can be entered as (x,y) or 


(x y). 
hardcopy c *.logic* 


xi 


Preface 


Documentation Figure 1 lists the documentation conventions used in 
Conventions this manual. 


Figure 1. Documentation Conventions 
Convention Meaning Example 
bold font Literal keyboard input set path = 
[optional] Optional user input; brackets [-options} 


are for document clarity only 
and should not be entered 


Name of key or button the 


user should press 


sans serif Variable; must be replaced by user_name 
italic font specific values supplied by the 
user 


pt Use the cursor controller to 
select a point on the screen 
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GED Commands 


Ths section contains descriptions of all GED com- 


mands. Note the following information: 
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For all commands requiring a cursor point, the 
point entry is abbreviated as pt. 


For all commands requiring a directory name, the 
directory variable is abbreviated as <dir>. The 
angle brackets are required. 


The use of ellipsis (...) indicates that the preced- 
ing fields on the command line can be repeated 
any number of times. 


If a sequence of items is enclosed in parentheses, 
(), followed by ellipsis, only the enclosed se- 
quence can be _ repeated. For example: 
( pt? pt2)... 


GED Commands 


add Adds a specified body to a drawing. 
| SYNTAX | add body_name[.[body][.[version]}] pt [pt ...] ... 
body_name The name of the body drawing to be added. 
body The type of body can be specified, but is not 
required. 
version The version defaults to 1, but any existing version of 


a body can be added. 


Bodies refer to library components as well as 
-BODY drawings created for hierarchical designs. 
To add library parts to a drawing, specify the re- 
quired library with the library command. 


Each SCALD directory in the current search stack is 
searched until the drawing with name 
body_name.body is found. GED does not allow 
TIME or SIM parts in logic drawings. Similarly, 
SIM parts cannot be added to TIME drawings, and 
so on. The directory <*> command tells whether 
any of the SCALD directories in a user’s list are of 
the wrong type for the currently-edited drawing. 


To add a body to a drawing: 


1 Type: 
add body_name 


A copy of the body is attached to the cursor. 
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GED Commands 


This step is optional. 


This step is optional. 
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2 If necessary, press the white button to rotate 
the body. 


3 Move the body to the required position in the 
drawing and press the yellow button. 


4 If necessary, press the yellow button to add 
another copy of the same body to the drawing 
and position the copy as described above. 


The add command remains active until another 
command is entered or the semicolon is selected. 
Additional bodies can be added to the drawing with- 
out reselecting the add command. To add a new 


body, type the name of the body and press (Geturn)}. 


add remembers the body that you added last and 
attaches it to the cursor if you enter the add com- 
mand and press any button. The cursor must be 
within the drawing area. 


The window and zoom commands can be nested 
within the add command. 


The add command can cause the following error 
message to appear: 


Could not find device of name: body_name 


This message indicates that GED could not find the 
specified body or that you tried to add a part from 
an illegal library. For example, you cannot add 


GED Commands 


bodies from the TIME or SIM library to a LOGIC 
drawing. If you receive this error message: 


e Check the spelling to make sure that you 
typed the name of the body correctly. 


e Make sure that the required component li- 


brary is specified. library lists the 


available libraries. 


e Make sure that the specified part is included 
in the library. List the contents of the library 
directory. | 


add 1s74 
Adds version 1 of the part LS74 to the drawing. 


EXAMPLES { 


add addr. .2 
Adds version 2 of the part ADDR to the drawing. 
See Also 
directory Lists the contents of a library. 
library Adds a library to the active search list. 
replace Substitutes one body for another. 
version Selects an alternate version of a body, if available. 
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GED Commands 


arc Draws arcs and circles. 


are pt? pt2 [ pt3 ] ... 


The arc command facilitates bodies that contain 
arcs and circles. To draw an arc: 


1 Type: 


arc 


and enter two points to indicate the ends of 
the arc. 


Select the semicolon (;) or A circle is drawn with the two initial points 
the arc command to place forming its diameter. A flexible wire running 


Ce oe ane between the initial points is attached to the 
rather than an arc. 
cursor. 


2 Position the arc as required and enter a third 
point to determine the curvature of the arc. 
The arc passes from the first point, through 
the third point, and ends at the second point. 


e Press the yellow button to position the 
curve of the arc at the nearest screen 
pixel. 


e Press the white button to position the 
curve of the arc at the nearest grid 
intersection. 


To make a semi-circle, place the third point 
anywhere on the circle itself. 
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See Also 


First point —>» 


Subsequent arc 


circle 


“™ Second point 


Third point 
(on the circle) 


Subsequent arc 
(semicircle) 


Figure 2. Creating an Arc 


Draws circles and arcs using a center point and a 
radius rather than the diameter to specify the size of 
the circle or arc. 
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assign 


function_key 


key_name 


"command text" 
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Assigns a GED command or operation to a program- 
mable function key. 


assign function_key "command text" 
assign key_name "command text" 


After you type assign, you can press the function 
key to be assigned and then type in the command 
text to be assigned to that key. 


Rather than pressing the function key, you can type 
the function key name and then enter the command 
text to be assigned to that key. 


The GED command and its arguments to be as- 
signed to the function key. 


The assign command assigns text, such as a GED 
command, to a function key so that you can press 
the specified key instead of typing the text. This can 
save time when a command is used often or requires 
several variables and options on the command line. 


Default function key assignments for commonly- 
used GED commands are supplied with GED. 
These values are stored in the softkeyassign file in the 
system editor directory. 


The current function key assignments can be dis- 
played with the show keys command. The soft key 
assignments can be tailored for the entire system by 
defining additional function key values. 


GED Commands 


You can also type assign 
and the function key name 
(for instance, LF2). 


The recommended method for changing the function 
key assignments is to place assign commands in in- 
dividual startup.ged or script files. These values 
then take effect whenever you use GED. Allter- 
nately, you can issue the assign command during 
an editing session to make function assignments that 
last only during that session. 


To use the assign command: 


1 Type: 


assign 
2 Press the required function key. 


3 Type the GED command to be assigned. 


The command and its arguments must be en- 
closed in quotation marks. 


4 Press (Return). 


You can also define keys by putting assign state- 
ments in your startup.ged file. You identify the func- 
tion key by typing the name of the key. The com- 
mand text must be enclosed in quotation marks. A 


is automatically appended to the end of the 


assigned string. 


The name of the key corresponds as closely as possi- 
ble with the text printed on the keyboard. Letters 
can be either uppercase or lowercase. 
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The number keys on the nu- 
meric keypad are preceded 
with K. The hyphen on the 
numeric keypad is named K_. 
The names of keys with two 
words are joined into one 
word with an underscore 
character. For example, 
Next Screen becomes 
Next_Screen. 
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On SCALDsystems, the keys are named: 


e LF2 - LF9 
e RFI - RF12 
e TF1 - TF6 


On Sun workstations, the keys are named: 
e Fi -— F9 
e Ri - RO 


The L1 - L10 keys cannot be assigned. 


On VAX workstations, the keys are named: 
e F6 — F20 
e Ki - K9 


On the PC AT workstation, the keys are named 
Fi - F10. 


To increase their usefulness, various control keys 
can be pressed in combination with function keys to 
create more command possibilities. These control 
keys and abbreviations are: 


SHIFT S 

CONTROL C or CTRL 

ALT A (PC AT) 
SUPER (LF10) SU (SCALDsystem) 
HYPER (LF11) H (SCALDsystem) 
META (LF12) M (SCALDsystem) 


GED Commands 


To use a key combination with the assign com- 
mand, type the name of the modifier key followed 
by a dash and the name of the function key. 


assign (press LF6) "display 2.0" 


This example assigns the command display 2.0 to the 
LF6 function key on a SCALDsystem. 


assign K6 "display 2.0" 


This example assigns the command display 2.0 to the 
number 6 key on the numeric keypad of a VAX worksta- 
tion. This version uses the key name (K6) to identify the 
function key. 


assign SHIFT-LF2 "window 2.0" 


This example assigns the command window 2.0 to the 
Shifted LF2 key (the LF2 key is pressed simultaneously 
with the shift key) on a SCALDsystem. 


See Also Section 1 (GED Overview) of the ValidGED User’s 
Guide describes the default function § key 
assignments. 
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auto 


dots 


Path properties 
are automatically 
assigned when a 
drawing is 
written. The 
auto path com- 
mand allows you 
to assign path 
properties before 
you write the 
drawing. 


path 


undot 


See Also 


set 


1/15/89 


Performs the global addition or deletion of certain 
objects to a drawing. The dots option automatically 
inserts a dot at each wire junction. The path option 
automatically assigns the path property where re- 
quired. auto undot automatically removes all dots 
from the drawing except at the intersections of four 
wires. 


auto dots 

auto path 

auto undot 

Places a dot at each wire connection point in the 
current drawing. Open dots are the default value. 
Before using the auto dot command, you can issue 
the set dots _ filled command to specify that filled 
dots be displayed. 


Makes bodies with the same name unique by assign- 
ing the PATH property. auto path assigns a unique 
path number (path = nP) to each body without a 
PATH property. 


Removes all dots from the drawing except those at 
the intersections of four wires. 


Allows you to specify the style of dots to be dis- 
played (open or filled). 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains more information about the PATH 
property. 
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backannotate 


12 


annotation_file 


Annotates designs with physical information from 
the Packager. 


backannotate [annotation _file] 


GED reads a schematic annotation file produced by 
the Packager and includes physical information such 
as location designators, pin numbers, and physical 
net names on the design. 


The annotated properties added by GED are soft 
properties. Soft property names begin with a dollar 
sign ($) and are not written into the connectivity file. 
This allows the Packager to reassign the physical in- 
formation each time the design is repackaged. 


You can move and delete soft properties, or you can 
change a soft property into a hard property by using 
the property command and adding a property with 
the same property name, minus the dollar sign. 


For example, if a component has a $LOCATION 
property, add a LOCATION property. 


To generate a back annotation file for GED: 


1 Run the Packager with the following direc- 
tive: 


output backannotation; 


There are options for backannotating location 
designators, pin numbers, and physical net 
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names. See the ValidPackager Reference 
Manual and the description of the set com- 
mand in this manual more information. 


This step is optional. 2 If necessary, rename pstback.dat to 
backann.cmd. The file pstback.dat is gener- 
ated by the Packager. The backann.cmd file 
must be in the current directory. 


3 Enter GED and type: 
backannotate 


If you did not rename pstback.dat to 
backann.cmd, specify the name of the backan- 
notation input file on the command line. For 
example, enter: 


backannotate pstback.dat 


GED reads the file, edits each named drawing in 
turn, adds the appropriate physical information, and 
writes the drawing. 


See Also 
property Adds a property to a design. 


set Several options control the placement of pin num- 
bers on the drawing. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains more information about properties, 
and Section 6 (Adding Physical Information) discusses 
backannotation and physical design information. 
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bubble 


SYNTAX 


See Also 
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Toggles the state of a pin between bubbled and 
unbubbled. 


bubble pt ... 


The bubble command toggles the state of a pin be- 
tween bubbled and unbubbled if the body is defined 
to permit this conversion. If the pins are established 
as part of a bubble group, the bubble command can 
be used to convert the body from one form to 
another. 


GED supports IEEE bubbles. Following standard 
GED usage, objects that look like IEEE bubbles in 
body drawings are interpreted as bubbles in 
connectivities. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains information about defining bodies. 
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busname 
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bus_name 


pt? pt2 


Places equally-spaced, single-bit vectored signal 
and pin names on the drawing. 


busname bus_name pt7 pt2 
busname pt? bus_name pt2 
busname pt? pt2 bus_name 


A simplified SCALD signal syntax name, such as 
A<0..3>. 


The two points specify the location of the first two 
names. Remaining names are placed automatically, 
with spacing between each name defined by the first 
two points. 


The busname command provides a convenient 
shorthand for naming signals in buses, or pins on 
bodies, whose names differ only in array subscripts. 
The name you specify is a simplified SCALD signal 
name, such as: 


ADDRESS<7..0> 


GED reads the system-wide config.dat file to deter- 
mine the array subscript string, such as two 
dots (.. ) or a colon (:). Bus bit ordering (left-to- 
right or right-to-left) is ignored. Table 1 illustrates 
bus name syntax and the resulting signal names. 
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i re 


Table 1. Bus Name Syntax 


Signal Name 


A<8>, A<2>, A<1l>, A<0O> 


A<O>, A<1l>, A<2>, A<38> 
A<O> 
A<7>, A<5>, A<3>, A<l1> 


The NI refers to the signal 
interface property. For. 
more information on signal 
properties, refer to the 
SCALD Language Manual. 
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If the array subscript character is a colon (:), the 
field separator becomes a double colon (::). For 
example, A<0:7::2> becomes: 


A<O>, A<2>, A<4>, A<6> 


GED draws a bright line between the name and the 
wire to which the name is attached to verify that the 
signal names are attached correctly. 


You can draw a 4-bit counter body with outputs 
shown as four separate, evenly spaced wires. To 
add signal names: | 

1 Type: 


busname A<8..0>\I 


GED attaches the string A<3>\I to the cursor. 


2 Place the name at the top wire and press the 
yellow button to enter the point. | 


GED attaches the string A<2>\I to the cursor. 


1/15/89 


GED Commands 


See Also 
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signame 


3 Position the second name and press the yel- 
low button. 


This name and the remaining two signal 
names are placed on the drawing. 


The bright lines are displayed so you can verify the 
attachment of signal names to the drawing. 


Attaches signal names to wires or pins. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains information about properties and sig- 
nal names. 


The SCALD Language Reference Manual contains in- 
formation about signal name syntax. 
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group_name 


Allows you to use a line editor or screen editor to 
modify selected lines of text. 


change group_name ... 


You can choose text strings to change by pointing 
with the cursor and pressing the yellow button. You 
can select as many strings as necessary. 


You can place strings to be edited in a group and 
then specify the group by name or by pressing the 
white button. 


The change command allows you to use a line edi- 
tor or screen editor to modify selected lines of text, 
such as notes, signal names, and properties, in a 
design. 


To use the change command: 
1 Select the change command from the menu 
or type: 
change 


2 Select the text string(s) or group to be edited. 


GED replaces the status line at the top of the 
display with the first line of text to be edited. 
You can now use the GED line editor or the 
system editor to change the selected text 
strings. 
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Note: 


Using the GED Line 
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Editor 


To use the system editor, enter (Controd) -Vv. GED 


writes all the selected text strings to a file, one 
string to a line, and accesses the system editor. Use 
the editing functions to move around the file and 
make the required changes. If you add notes to the 
file, they are placed on the drawing below the last 
note you changed. You cannot delete lines from the 
file; use the delete command to remove the text 
strings from the GED drawing instead. 


The system editor can be set with the 
set user_editor command. The default is vi on 
UNIX systems and EDT on VMS systems. 


When you are finished, exit from the system editor. 
The changed text is repositioned on the drawing. 
Refer to the appropriate manual for more informa- 
tion about the system editor. 


To run the system editor from NGED, enter the 
change command and a group name to be changed: 


change a 


The change command will automatically access the 
system editor. 


The line editor uses a vertical-line cursor. Table 2 
contains the key combinations and the resulting op- 
erations you can perform in the line editor. 


To insert text to the right of the cursor, type the 


characters to be inserted, then press (Return). 


To select a new line of text, point to the text string 
and press the yellow button. 
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Table 2. Line Editor Functions 


Moves the cursor to the beginning of the line. 
Moves the cursor backward one character. 


A 
@ 
< 
77) 


byt fl 
oO; v0 )| } 


Deletes one character to the right of the cursor. 
Moves the cursor to the end of the line 

Moves the cursor forward one character 
Deletes one character to the left of the cursor. 
Deletes the remainder of the line (right of the 
cursor). 

Displays the help file for the line editor. 


Searches to the left of the cursor for the specified 


character Searches to the right of the cursor for the 


specified character. 


| | | 
A | xo; 


|OOOGEBE 


| 
2) 


Re 


pa 
® 
ie) 
[?) 
Lo 
@ 
® 


” 


AEE 


Repeats the command n times. If no number is 
given, the default is four. 


I 
Cc 
> 
° 
3 
Q 


Place all selected text strings (that have not yet 
been edited) into a file and run the system editor 
on that file. 


Repositions the text currently on the edit line and 
displays the next line of text to be edited. When 
all text has been edited, exits the line editor. 


Aborts changes to the text currently on the edit 
line. 
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check 
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Checks for connectivity problems and general errors 
on the current drawing. 


check 


The check command adds PATH properties and ex- 
amines a drawing for connectivity problems and 
other general errors. These problems are difficult to 
detect by looking at the drawing and cause compila- 
tion errors. check looks for: 


Pins attached to more than two wire segments 
Duplicate components in the same location 


Wires connected to only one pin and not 
named (NC wires) 


Nets that are named but not connected to any 
pins 


Wires that come close to but do not contact 
pins 


Duplicate PATH properties 

Unmarked wire connections 

Wires overlapping a body 

Missing TITLE and/or ABBREV properties 
Bodies that are placeholders 


Pins located at the origin (0,0) in BODY 
drawings 
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See Also 


error 


set 
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Multiple dots at the same location 


Hard properties with the ? value 
(placeholders) 


Objects partially outside the GED drawing 
boundaries 


Wires connecting the pins of a two-pin body. 


check lists each detected error. After you run the 
check command, you can use the error command 
to locate each error on the drawing. 


Locates and displays each error detected by check. 


The check_on_write option determines whether 
check is automatically invoked every time you write 
a drawing. 
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circle Adds circles and arcs to a drawing. 


circle center_pt radius_pt [end_pt] ... 


center _pt The center point of the circle. 


radius_pt The second point of the circle or arc. This point is 
used to determine the length of the radius. 


end_pt This third point, along the circumference of the cir- 
cle, is only used when drawing an arc. This point 
determines the length of the arc. 


The circle commandcan be used to create both cir- 
cles and arcs. Although circles and arcs are rarely 
necessary on logic designs, they are commonly used 
for creating body drawings. 


To place a circle on the drawing: 


1 Select circle from the menu. 


radius_pt . 
2 Select a point as the center of the circle. 


° 
center_pt : é P 
3 Select a second point to determine the radius. 


The circle appears. 
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An arc is defined by three points: the center, a point 
marking the termination of the radius, and a third 
point along the circumference of a circle. 


To draw an arc: 


1 Type: 


radius pt , 
?P circle 


© center_pt and select the center point. 


end_pt P . 
2 Select a second point to determine the length 


of the radius and the starting point of the arc. 
The completed circle appears as soon as the 
radius point is specified. 


3 Position the cursor along the circumference 
of the circle and specify an ending point to 
determine the length of the arc. The arc is 
drawn from the starting point counterclock- 
wise to the ending point. 


See Also 


arc Facilitates the creation of arcs on a drawing. Uses 
diameter rather than center point and radius to de- 
fine the size of the circle. 


24 1/15/89 


GED Commands 


connect 
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program 


off 


show 


led 


Provides a general interprocess communication facil- 
ity for GED. (Not available on PC AT system). 


connect program 
connect off 
connect show 
led 


connect provides a general interprocess communi- 
cation scheme for GED on SCALDsystem. A 
program connected to GED can send commands that 
GED can execute. Several Valid tools have built-in 
connections to GED. For example, simulate starts 
the split-screen Simulator; connect simulator con- 
nects to a Simulator process that is currently run- 
ning in a different window. 


Causes GED to disconnect the currently-connected 
process. 


Lists the connections GED currently knows. 


A synonym for connect led. 


The connected process has commands that allow 
you to perform queries about signals and bodies in 
the currently edited drawing. For example, LED 
has the show net command. GED searches its 
database and reports the results to the connected 
process and in the GED drawing area. 


The names of programs that can be used by 
connect are established by placing connect com- 
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mand lines in the system-wide startup files. Con- 
nections to LED, CONCORDE, ValidSIM, and 
COMPARE are specified in the system-wide 
startup.valid file. You must enter connect com- 
mands in both GED and the other process. If the 
processes fail to establish a connection within about 
30 seconds, a message is displayed. GED can only 
connect to one process at a time. 


In startup.valid, the command 


connect simulator unix ”/tmp/gedsimS” 


allows GED to connect to a program named 
SIMULATOR using /tmp/gedsimS. This command 
is specified by the system manager and identifies 
the UNIX socket, the discipline, and the number of 
the GED window. The discipline is platform- 
specific: 


e UNIX is on SCALDsystem only. 
e MSPMPX is on Sun3 and Sun4 only. 
e VMSAD is on VAX only. 


If you enter the connect sim command in GED and 
the connect ged command in the Simulator, the 
two programs can connect together. The Simulator 
open command uses this interface and allows you to 
select signals in the GED drawing. 
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copy 


number 


source_pt 


property _pt 


group_name 


destination_pt 


attach_pt 
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Copies objects, properties, and groups in the current 
drawing. 


copy [number] source_pt destination_pt ... 
copy [number] group_name destination_pt ... 
copy property_pt destination_pt attach_pt ... 


The number of copies to place on the drawing. Af- 
ter the first copy is placed, the remaining copies are 
automatically added to the drawing. The second 
copy is offset from the first copy by the same dis- 
tance as the first copy from the original. You can 
use this feature to copy single items and groups. 


Identify an object to copy. 

Identify a property to copy. 

You can choose a group to copy by using the cursor 
controller and the white button, or you can type in 
the single-letter group name to identify the group. 


The position of the new copy. 


When you copy a property, a third point attaches the 
property to an object (body, pin, or wire). 
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To copy an object (such as a body or wire): 
1 
2 


Select copy from the menu. 


Position the cursor on the object and press 
the appropriate button. 


e The yellow button picks up a copy of the 
object at the grid point nearest the cursor. 


e The blue button picks up a copy of the 
object at the vertex nearest the cursor. 
(The vertex of the copy snaps to the cur- 
sor.) This operation is useful for copying 
component bodies and wires. 


Move the copy to its location and press the 
appropriate button. 


e The yellow button places the copy on the 
grid point nearest the cursor. 


e The blue button attaches the copy to the 
nearest vertex. This is useful for attach- 
ing copies of wires at new locations. 


To copy a group: 


1 


Use the group or select command to define 
a group. 


Select copy from the menu. 
Move the cursor to the group to be copied 


and press the white button. This selects the 
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nearest group and attaches it to the cursor 
relative to the cursor’s position when the but- 
ton is pressed. 


or 


Type the single-letter group_name and press 


(Geturn). 


4 Move the cursor to the location for the copy 
and press the yellow button. Groups of prop- 
erties are not copied. 


When you copy a group of objects containing prop- 
erties, a warning message is displayed. When appli- 
cable, properties attached to objects are copied with 
the group. 


To make multiple copies: 


1 Issue the copy command and enter a number 
to specify the number of copies to be made. 


2 Move the cursor to the object or group to be 
copied and press the appropriate button. 


e The yellow button selects an object. 


@ The white button selects a group. 
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3 Move the copy to its location and press the 
appropriate button. 


e The yellow button picks up a copy of the 
object at the grid point nearest the cursor. 


e The blue button picks up a copy of the 
object at the vertex nearest the cursor. 


To copy properties: 
1 Select copy from the menu. 


2 Move the cursor to the property to be copied 
and press the yellow button. 


3 Move the cursor to the location for the copy 
and press the yellow button. 


A rubber band line is drawn from the prop- 
erty to the cursor. 


4 Move the cursor to the object where the prop- 
erty is to be attached and press the yellow 
button. 


You can attach the property to a part, wire, 
pin, or signal name. | 


You cannot copy default body properties, pin prop- 
erties, or properties generated by the section, 
pinswap, and backannotate commands. 


Default properties and user-added body properties 
are included in copies made of parts. Wire proper- 
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cut and paste 


group 


select 


ties are not included when you copy a wire. If a 
default body property on a body was changed, a 
copy of the body contains the changed value. 


The window and zoom commands can be nested 
within the Copy command. 


These commands allow you to copy objects or 
groups from one drawing to another. 


Defines a group of objects (which can then be 
copied). 


Defines a group of objects (which can then be 
copied). 
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SYNTAX 


pt 


group_name 


Copies an object or a group from the drawing to a 
buffer. 


cut pt 
cut group_name 


Selects an object to cut. 


You can choose a group to cut by using the cursor 
controller and the white button, or you can type in 
the single-letter group name to identify the group. 


The cut command, in conjunction with the paste 
command, allows objects and groups to be copied 
from one drawing to another. Use the cut com- 
mand to place the specified object or group into a 
cut buffer. The cut buffer can contain only one 
group or object. 


1 Type: 
cut 
2 Select the object to be cut by pointing with 
the cursor and pressing the yellow button. 
or 


Select the group to be cut by typing the group 
name or pointing with the cursor and press- 
ing the white button. 


The cut command highlights the selected object or 
group and also displays the number of bodies, wires, 
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copy 


paste 


dots, circles, and notes from the group that have 
been put into the buffer. 


Default body properties and user-added body prop- 
erties are included in copies made of parts. Proper- 
ties that are not copied with the body include the 
PATH property, properties generated by the 
pinswap, section, and backannotate commands, 
and pin properties. Wire properties are copied when 
a wire is cut to allow signal names to be transferred 
to the new drawing (unnamed signal names are not 
copied). 


Makes copies of objects and groups in the same 
drawing. 


Transfers objects from the cut buffer to the speci- 
fied locations in the current drawing. 
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delete 


pt 
group_name 
See Also 
undo 
34 


Removes objects from a drawing. 


delete pt ... 
delete group_name ... 


Selects an object to delete. To delete an object, 
point to any part of the object and press the yellow 
button. delete removes the object nearest to the 
cursor. 


You can choose a group to delete by using the cur- 
sor controller and the white button, or you can type 
in the single-letter group name to identify the group. 
The group nearest the cursor is deleted. 


Default properties on bodies and pin number prop- 
erties generated by pinswap cannot be deleted by 
the user. 


If a group or object is deleted by mistake, use the 
undo command to retrieve it. 
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diagram Changes the name of the current drawing. 


diagram [<dir>] [drawing_name}] [. [type] [. [version] [. [page] ]]] 


<dir> The directory name where the drawing resides. If 
no directory is specified, the current directory is 
used. 
drawing_name The new name of the drawing. If no drawing name 


is specified, the current drawing name is used. 


.type.version.page The drawing type, version number, and drawing 
page number are optional. If not included, the cur- 
rent drawing type is used, and the version and page 
number default to 1. 


The diagram command is used to change the name 
of the current drawing. This allows you to use an 
existing drawing as a pattern for a new drawing or 
to save a copy of a drawing under a different name 
before making changes to it. 


To rename a drawing: 
1 Edit the drawing to be changed. 
2 Type: 
diagram 
and the new name of the drawing. 
3 Type: 
write 


to save a copy of the drawing under its new 
name. 


1/15/89 35 


GED Commands 


The diagram command is also used to change the 
type of a drawing. For instance, when changing a 
SIM drawing to a TIME drawing, GED substitutes 
primitives from the TIME library for the SIM primi- 
tives where possible on the drawing. 


edit test1.logic 
diagram finaltest.logic 
write 


EXAMPLE 
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directory Lists the contents of SCALD directories. 


directory [<dir>] [drawing_name] [. [type] [. [version] [. [page]]]] 


<dir> List the specified directory. If no directory is speci- 
fied, the current directory is used. 
drawing_name List the specified drawing. 
.type.version.page Unless you specify type, version, and page parame- 


ters, the directory command displays just the draw- 
ing name. You can also list drawings by type or 
select only certain versions or pages to list. 


The directory command lists the names and con- 
tents of the SCALD directories in the current direc- 
tory list. There is no limit to the number of SCALD 
directories you can use at one time. The directory 
command displays the contents in the order the di- 
rectories are searched, with the current working di- 
rectory displayed first. After a screenful of text, the 
following prompt is displayed: 


More (ync) 


Y or Yes. Present more information. 
Nn orqd No. Do not print any more output. 


c Continue. Print the entire message output without 
pausing for page prompts. 


You can use wildcard characters in directory names 
and drawing names. An asterisk (*) matches any 
string, and a question mark (?) matches any single 
character. 
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directory 


EXAMPLES § 


Lists all drawing names in the current SCALD directory. 


directory <*> 


Lists all active SCALD directories (but no drawing 
names). 


directory <time>* 
Lists all drawing names (parts) in the TIME library. 


directory ls* 


Lists all drawing names beginning with |\s in the current 
SCALD directory. 


directory *.body* 
Lists all BODY drawings in the current SCALD directory. 
directory <*>* 


Lists all drawing names in all active SCALD directories 
and libraries. 


directory *.* 


Lists the name, type, and version of each drawing in the 
current SCALD directory. 


See Also 


ignore Excludes the specified directory or library from the 
active search list. 


library Specifies the component library to be accessed. 
With no arguments, lists all available libraries. 


use Specifies the current working directory or library on 
the active search list. 


Section 2 (The Editing Environment) of the ValidGED 
User’s Guide describes SCALD directories and their 
operation. 
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option 


"group_name" 


pt 
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Changes the way objects are displayed on a drawing. 


display option "group_name" 
display option pt ... 


Several options can be specified with the display 
command. You can change the display of: 

e Properties 

e Text size 

e Text justification 

e Wire size 

e Dots 


Individual options are listed following the syntax ex- 
planations. 


You can choose to change the display of a group by 
using the cursor controller and the white button, or 
you can type in the single-letter group name to iden- 
tify the group. The group name specified must be 
quoted. The group can contain any type of object. 


You can choose to change the display of a single 
object by using the cursor controller and the yellow 
button. The display command selects the appropri- 
ate object to change. 


Group names, options and point entries may be in- 
cluded in any order and in any combination, except 
that the first argument must be a command option. 
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40 


name 
value 


both 


invisible 


EXAMPLE f[ 


The options name, value, both, and invisible deter- 
mine the way properties are displayed on the draw- 
ing. Although a property consists of a name and 
value pair, usually only the value is displayed when 
a property is added to a drawing. These options 
allow you to display the name alone, the value 
alone, both, or neither. 


Displays only the name of the property. 
Displays only the value of the property. 


Displays both the name and the value of the 
property. 


Displays neither the name nor the value of the 
property. 


To change the display, enter the command and the 
required option, and then select one or more proper- 
ties with the cursor. After the form of a property 
has been changed, that change remains in effect un- 
til another display command is used to change it 
again. 


You can define a body with a default property 
SIZE = 1B and suppress the display of the property 
with the display invisible command. When that 
body is added to a logic drawing, the property 
SIZE = 1B does not appear. Use the display value 
option and point to the location of the property to 
make it appear on the drawing. The command 
show properties displays the name and value of all 
properties (including invisible ones) on the drawing. 
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Text Size 


default 


scale_factor 


The set size command 
allows you to change the 
default size of added 
text. 
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The default and sca/e_factor options determine the 
size of text displayed on the drawing. 


Displays text on the drawing at the default size, 12 
characters per inch. 


Enlarges or reduces the size of the text on the draw- 
ing by the amount specified by scale_ factor. Nega- 
tive scale factors are treated as inverses to allow a 
simple method of undoing a text size change. If you 
select a scale_ factor larger or smaller than GED’s 
limit, GED sets the size of the text to the maximum 
or minimum value. 


When a text string is added to a drawing, it is de- 
fined by a vertex at the lower left corner of the text 
string. Text is added to a drawing at 12 characters 
per inch. This size of text is legible on a hardcopy 
of the drawing without taking up more space than 
necessary. 


To change the size of a string of text: 
1 Type: 
display scale_factor 


to indicate the factor by which the size of the 
currently displayed text is to be multiplied. 


2 Use the cursor to select the text string to 
change. 


To return the text to the default size, type: 
display default 


and point with the cursor to specify the text. 
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Text Justification 


left_ justified 
right_ justified 


center_ justified 


Wire Size 


heavy 
thin 


pattern number 


Dots 


filled 


open 
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By default, all user-added text is left—justified. 
Left-justifies selected text strings (default). 
Right-justifies selected text strings. 
Center-justifies selected text strings. 


When the vertex of a right-justified string is selected 
(blue button), the cursor attaches to the right end of 
the string. 


You can change the way an existing wire appears on 
a drawing. 


Makes the wire thicker so it looks like a bus. 
Returns a heavy wire to the default wire thickness. 


Changes a wire to one of six patterned lines. Pat- 
tern 1 is a filled line (the default); patterns 2-6 are a 
variety of dotted and dashed lines. 


In a LOGIC drawing, the entire net changes. In a 
BODY or DOC drawing, only the wire segment 
specified by the cursor is changed. 


The filled and open options change the display of 
dots already added to the design. 


Displays solid dots. 
Displays open dots (default). 


Open dots scale when the window, zoom, or scale 
command is used; filled dots do not. The 
set dots_filled command makes dots added to the 
drawing filled by default. 
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display invisible "a" 


Makes all properties in group A invisible. The quotation 
marks around the group name are required. 


display both pt 


Displays the name and the value for the selected 
property. 


display 2 pt 


Enlarges the selected text by two times. 


display .5 pt 

Makes the selected text half as large. 

display -4 pt 

Reduces the selected text four times. This is the same as 


display .25. 


display filled pt 


Makes the selected dot solid. 
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find 


group 


select 


set 


show 


Allows you to define a group of text to be manipu- 
lated by the display command. 


Allows you to define a group by drawing a closed 
polygon around the required objects. 


Allows you to define a group of objects with a 
stretchable rectangle. 


Allows you to change the default options used by 
GED. The set options that affect the same drawing 
elements as the display command are: 


e dots filled 

e dots open 

© left_ justified 

e center_ justified 

e right_ justified 

e prop display 

e size 
Temporarily displays drawing information. Several 
show command options affect the same drawing 
elements as the display command. The show com- 


mand is useful for viewing the current values on the 
drawing before making changes with display. 
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See Also 


auto 


display 


set 


show connections 
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Adds dots to drawings to indicate connection points. 


dot pt... 


The dot command is used to add dots to drawings. 
Dots are used in logic drawings to indicate that 
wires crossing one another are connected. (By 
default, wires crossing are not connected unless 
dotted. 


Wires joining at a “tee” are connected, even without 
a dot. Dots are used in body drawings to indicate 
pin connection points. Dots can be filled or open. 
By default, all added dots are open. 


auto dot places a dot at all connection points in a 
logic drawing. auto undot automatically removes 
all dots except at the intersections of four wires. 


The filled and open options change the style of se- 
lected dots displayed on the drawing. 


set dots filled and set dots_open change the de- 
fault dot type. 


Temporarily displays all connection points in a logic 
drawing. 
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echo Displays messages from a script file on the GED 
screen. This allows you to track the progress of a 
GED script, and is useful for debugging purposes. 


echo message_line 


SYNTAX ff 


message_line The message to be displayed. 
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edit Displays an existing drawing to be edited or allows 


you to create a new drawing. 


edit [<dir>] [drawing_name] [. [type] [. [version] [.[ page]]]] 
edit pt 


<dir> Search for the drawing in the specified SCALD di- 
rectory. If no directory is specified, each directory 
in the list is searched until a drawing of that name is 
found. 


dwg The name of the drawing to edit. If the specified 
drawing is found, it is displayed on the screen. If it 
is not found, the system creates a drawing by that 
name in the current SCALD directory when you 
write the drawing. If the drawing name is omitted, 
GED uses the name of the current drawing. 


.type.version.page If the drawing type is not specified, GED uses the 
default type specified by the set push_type com- 
mand, initially set to LOGIC. To edit another type 
of drawing, include the drawing type after the draw- 
ing name. — 


The default value for both version and page is 1. 
Page specifications for body drawings are ignored, 
but each body can have multiple versions. Other 
drawing types, such as TIME, and SIM, can also 
have multiple versions and pages. 


pt The edit command allows you to examine the draw- 
ings associated with bodies on the screen. By de- 
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fault, the LOGIC drawing of a hierarchical body is 
edited when you select the body from the current 
drawing. You can also change the default drawing 
type by using the set push_type command. 


For example, to edit the logic associated with a body 
(for example, SUBTRACTOR) in the current draw- 
ing, type the edit command, point to the body with 
the cursor, and then press the yellow button. The 
current drawing is placed in temporary storage, and 
the drawing SUBTRACTOR.LOGIC is displayed and 
can be edited. 


You can use the edit command to edit a second 
drawing without writing the current drawing. edit 
saves the first drawing, along with any changes, in a 
temporary file before bringing in the new drawing. 
If you edit the first drawing again, edit displays the 
modified version from temporary storage. 


ed test 


Displays drawing test.type.1.1. The type is determined 
by the set push_type command. The default is LOGIC. 


ed size shifter.time 


Displays the time drawing, size shifter.time.1.1. 


ed circuit...2 
Displays the second page of the drawing circuit with the 
type and version of the drawing being edited. 


ed ...2 


Displays the second page of the current drawing (the one 
named on the status line). 
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See Also 
get Replaces the current drawing with the version stored 
on the disk. 
return Returns to the previously—edited drawing. 
set push_type Changes the value of the default drawing type. 
show history Lists the drawings that have been edited during the 


current GED session. 
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endsim 


SYNTAX 


See Also 


simulate 
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Terminates a session with the split-screen simulator. 


endsim 


The endsim command terminates a session with the 
split_screen simulator. This is necessary if you need 
to section or pinswap parts. 


Accesses the split_screen simulator. 
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Locates and displays each error detected by the 
check command. 


rror 


The error command steps through the errors found 
by check. It draws an asterisk at the location of the 
error and displays a message describing the error. 


After you correct an error, proceed to the next error 
by retyping the error command or selecting it from 
the last box on the menu. 
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SYNTAX § 


pt 


group_name 


option 


odies 


connections 


group_name 


Removes items or groups from a group. 


exclude pt [option] ... 
exclude group_name [option] ... 


To remove individual objects from the current 
group, press the yellow or blue button. To remove 
previously—defined groups from the current group, 
enter the single-letter group name. To remove the 
contents of the entire group, press the white button. 


The name of the current group. Any objects you 
specify are removed from the current group. Spec- 
ify the current group by entering the single-letter 
group_name. If you do not specify the group, the 
most recently generated group is used. The 
group_name must be included on the same line as 
the command. 


Several optional flags allow you to remove types of 
objects from a group: 


Remove all bodies from the group. 


Remove all body pins (but not the body origins) 
from the group. 


Press the white button or enter the single-letter 
group name to exclude a previously—defined group 


from the current group. 


Remove all wires from the group. 
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properties 


wires 


See Also 


find 


group 


include 


select 
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Remove all properties from the group. 


Remove all wires from the group. 


Defines a group of items that match a specified 
pattern. 


Allows you to define a group by drawing a closed 
polygon around the required objects. 


Adds items to a group. 


Provides a stretchable rectangle to specify the 
boundaries of a group. 
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exit Allows you to leave the editor. 


exit 


SYNTAX f 


The exit command allows you to leave GED. After 
you issue the exit command, GED displays a mes- 
sage if there are unwritten changes to the drawings 
in the current editing session. If you issue the exit 
command again, any changes to the drawings are 


lost. 
See Also 
quit Allows you to end the editing session. Same as exit. 
write Writes the current drawing to the disk. 
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filenote 


filename 
pt 
See Also 
note | 
1/15/89 


Includes a named text file in a drawing at a speci- 
fied point. 


filenote filename pt 


The name of the text file to add to the drawing. 


The position in the drawing to add the text. 


When the text file is added, each line in the file is 
converted into a note that can be individually 
moved, copied, deleted, or changed. Empty lines in 
the file are ignored. To include a blank line in the 
note, type a space on the line in the file. 


Adds individual lines of text to a drawing. 
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find Searches the current drawing and places all objects 


that match a specified pattern into a group. 


find pattern 


SYNTAX =f 


pattern A given pattern to match in the current drawing. 
The pattern can match: 


e Body names 

e Notes 

e Property names 
e Property values 
e Signal names 


You can use wildcard characters in the pattern. An 
asterisk (*) matches any number of characters, and 
a question mark (?) matches any single character. 
The find command is not case-sensitive; it does not 
distinguish between uppercase and lowercase alpha- 
betic characters in the pattern. 


The command assigns all matching items to a group. 
The number of items in the group is displayed on 
the screen. GED operations such as paint, show, 
delete, and display can also be performed on the 
entire group. 


All items found with the command are placed in a 
list. You can step though the list items using the 
next command. This command places an asterisk 
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next to each item on the display so it can be 
changed or deleted. 


find path=* 


Locates all path properties. 


find 1s00 


Locates all LSOO components on the drawing. 


find un$* 


Locates all unnamed signals. 


See Also 
exclude Removes objects or groups from a group. 
include Adds objects or groups to a group. 
next Steps through the list of items located by find. 
1/15/89 
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format 


SYNTAX | 


text_file 


new_drawing_name 
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Combines a text file with referenced drawings into a 
new drawing. 


format text_file new_drawing_name 


The name of the text file. 


The name of the new drawing. 


The format command creates a DOC drawing file 
by merging specified drawings with a processed 
ASCII text file. To use the format command: 


1 Type: 
format 


and the name of the text file. 


2 Press (Return). 


3 Type the name of the new DOC drawing. 


The text file can contain references to drawings to 
be included in the final document. The drawing 
name, preceded by an ampersand (&), and the num- 
ber of lines required by the drawing are inserted in 
the text file to mark the location of each drawing. 


The format command can accept the output of text 
processors such as nroff (UNIX) or Digital Standard 
Runoff (VMS). It cannot accept output from type- 
setting programs such as troff (UNIX). 
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filenote 
scale 


smash 


GED reads the named drawing, reduces it to its ba- 
sic components, and scales it to fit into the allotted 
space. Each page of the text file is turned into a 
page of a drawing DOC file. The pages created by 
format are 8-1/2 inches by 11 inches, with 6 lines 
per inch. A page ends automatically at line 60 ora 
user-specified formfeed ( (Controd)-L ). For easier 
readability, the characters are 1.29 times larger than 
the default character size. 


format design.dat 


specification 


Processes the text file design.dat and creates a GED 
drawing called specification.doc. 


Allows you to add a text file to a GED drawing. 
Includes a drawing into specified amount of space. 


Breaks a body into the separate objects that define 
it. 


Section 7 (Creating Mixed Text and Graphics) of the 
ValidGED User’s Guide contains more information 
about creating mixed text and graphics documents. 
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get Replaces the current copy of a drawing with the ver- 
sion stored on the disk. 


get [[<dir>] [drawing _name} [. [type] [. [version] [.[ page]]}]]] 


<dir> Retrieve the drawing from the specified SCALD di- 
| rectory. If no directory is given, each directory in 
the list is searched until the specified drawing is 
found. If the drawing is not found in the specified 
SCALD directory, the new drawing is assumed to 

belong to the current SCALD directory. 


drawing_name The name of the drawing to retrieve and display. 
.type.version.page The type, version number, and page of the specified 
drawing. 


The get command retrieves and displays the copy of 
the drawing stored on disk. This fresh copy of the 
drawing replaces any previously read (and perhaps 
modified) version in GED. get is useful if, while 
editing a drawing, you want to discard current work 
and go back to the previous version. 


To read in the disk copy of the current drawing, 
type: 


get 


See Also 
edit Displays a drawing to be edited. 
remove Deletes a selected drawing. 
return Returns to the previously—-edited drawing. 
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option 


off 


grid_size 


Alters the way the grid is displayed. 
grid option ; 


GED uses a grid of locations to help you place ob- 
jects and ensure alignment and connections. The 
purpose of the grid is to help you produce neat, at- 
tractive schematics and to facilitate the connection 
of wires to each other and to pins. 


The grid command is used to specify the way the 
grid is displayed. The current values of the grid 
spacing are displayed on the status line at the top of 
the screen. 


Individual options are listed below. End the grid 
command line with a semicolon (;) or by selecting 
any other command on the menu. 


Toggles the grid on and off. 
Displays the grid on the screen. 
Turns off the displayed grid. 


Specifies, in defined units of measure, the separa- 
tion of the grid lines. The default size for editing 
LOGIC, TIME, and SIM drawings is 0.1, or one- 
tenth of an inch. The grid_size (a real number) must 
be a multiple of 0.002 inches, which is the smallest 
possible grid separation. Table 3 shows the default 
grid spacings. 
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Be extremely careful when changing the grid size. Bod- 
ies could be placed off grid and then, if the grid size is 
again changed, wires might not be connected even when 
they appear to be. This is also why the blue button 
shoud be used whenever possible to connect wires to 
pins and other vertices. 


Table 3. Default Grid Spacing 
Grid Type 
Decimal 0.166 


Fractional 0.208 
Metric 4.15 


“Other” drawing types include LOGIC, TIME, and 
SIM. 


grid_size grid_multiple Specifies the grid size and multiple to be displayed. 


The multiple indicates how many lines of the grid are 
skipped before the next line is displayed. The de- 
fault value for LOGIC drawings is 5. You can spec- 
ify a positive integer to change the default grid mul- 
tiple. Specify 1 to display every line; 2 to display 
every other line, etc. 


dots Displays the grid as dotted lines. 


lines Displays the grid as solid lines. 


In decimal spacing, GED uses 500 internal units per 
physical inch. The grid multiple displayed on the 
status line of the display is in grids—per-inch. 
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If you use the set metric command to base plots on 
the metric system, GED uses 508 internal units per 
physical inch or 20 internal units per physical milli- 
meter. The grid multiple displayed on the status 
line is expressed in grids—per-millimeter. Metric 
users can use standard Valid libraries since pins are 
on 2.5 mm centers. 


With 500 internal units per inch, you cannot use a 
1/8 inch grid (the grid can be set to .124 or .126 but 
not .125). If you use the set fractional command, 
GED resets the internal units to 400 per inch. (This 
allows the Valid library components to remain com- 
patible with the drawing.) In this case, the bodies 
appear to be 25% larger, and the pins are placed on 
1/8 inch centers. 


Table 4 shows the default grid values. 


Table 4. Default Grid Values 


Grid Type Units/inch Units Minimum Spacing 
Decimal inches 


Fractional inches 
Metric mm 


See Also 


set Changes the default values used by GED. 
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group 
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SYNTAX =f 


group_name 


pt 


Combines selected objects into a group. 


group [group_name] [all] pt ... 


The name of the group; do not enclose the group 
name in quotation marks. If you do not assign a 
group name, a single-letter name is assigned by 
GED. 


Include the entire drawing in a group. 


Use the cursor controller to draw a polygon around 
the objects to be grouped. Press the yellow button 
to change the direction of the line. Close the poly- 
gon by pressing the blue button when the cursor is 
near the starting point. You can press the blue but- 
ton to include other objects in the same group. You 
can also draw more polygons to include other ob- 
jects in the same group. 


The group command creates a group of objects on 
which you can perform many GED operations. The 
group is defined as a collection of vertices, so any 
object with a vertex within the group is affected by 
an operation on the group. 


Objects are added to the same group until you use 


the group or select command to change the current 
group or enter a semicolon to end the command. 
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See Also 
exclude 
find 
include 
select 
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To define a group: 


1 Issue the group command. If desired, spec- 
ify the name of the group. 


2 Draw a polygon around the required objects. 


The screen displays the group name and the number 
of bodies, arcs, properties, notes, dots, and wires in 
the group. 


Many commands allow you to operate on entire 
groups. See the individual command syntax defini- 
tions for information on which commands operate 
on groups. 


Removes objects or groups from a group. 


Allows you to define a group of objects by matching 
text strings. 


Adds objects or groups to a group. 


Provides a stretchable rectangle to specify the 
boundaries of a group. 
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SYNTAX ff 


scale_option 


a,b,c,d,e 


scale_factor 


<dir> 


drawing_name 


.type.version.page 


Sends drawings to a plotter to produce a printed 
output. 


hardcopy [scale_option] [<dir>]drawing_name 
[. [type] [. [version] [. [page]}]]] 


Specifies the size of the printed output. There are 
two types of options: 


Specifies a page size to scale the drawing. 


Specifies a number to scale the drawing from the 
normal size. 


Plot the specified drawing from the specified 
SCALD directory. 


The name of the drawing to print. If a drawing 
name is given, a scale factor (number or page size) 
must be given. You can use wild card characters to 
specify drawings to be plotted. An asterisk (*) 
matches anything. This allows you to print several 
drawings with a single hardcopy command. 


The drawing type, version number, and page of the 
specified drawing. 


Plots can be made on dot matrix, electrostatic, or 
pen plotters, including Epson, Versatec, Hewlett 
Packard, CalComp, and Benson models. The set or 
set plotter command specifies the type of plotter to 
use. 
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hardcopy 30 


Plots the current drawing at the default scale of 1. 


hardcopy a 


Scales the current drawing onto an A-size page. 


hardcopy c *.logic* 


Scales all LOGIC drawings in the current directory onto 
C-size pages. 


hardcopy 1 <100k>100112.body* 


Plots all versions of the 100112 part from the 100k 
library. 


hardcopy 1 hyper mux 


Plots all drawing types for the drawing hyper mux 
(BODY, LOGIC, and SIM) in the current directory. 


See Also 
set Allows you to specify the type of plotter to be used 
with the hardcopy command and other plotting 
options. 


Section 5 (Producing a Hardcopy) of the ValidGED 
User’s Guide contains information about plotting 
drawings with your SCALDsystem. 
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help 
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SYNTAX ff 


command_name 


Displays the on-line documentation for a specified 
GED command. 


help command_name 


The name of the command help file to display. The 
help file briefly describes the syntax and the seman- 
tics of the selected command. 


To display a list of topics on which help is available, 
use the command syntax: 


help help 
or 


help ; 


If necessary, you can use the zoom or window com- 
mand to enlarge the size of the text or pan the help 
display. To exit from help, select another command 
(other than Zoom or window) from the menu or en- 
ter a semicolon. 
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SYNTAX § 


re 


rere nena, eee enone es ereneat satan ncstae tet cttoeeteaceat tate eaten 


directory_name 


library_name 


Causes a specified directory or library to be deleted 
from the active search list. 


ignore directory_name 
ignore /ibrary_name 


The directory name to be deleted from the search 
list. 


The library name to be deleted from the search list. 


When you issue the ignore command, the system 
prompts you to enter a semicolon to proceed with 
the operation. When you ignore a directory or li- 
brary, this command causes the specified SCALD 
directory or library to be deleted from the active 
search list. The argument specified can have wild 
cards. If more than one directory matches the pat- 
tern, each one is ignored. 


When you ignore a directory or a library, any bodies 
used in the drawing from the ignored directory or 
library are deleted from the screen. The body name 
is displayed as a place holder to remind you to re- 
place the body. The other active SCALD directories 
and libraries are searched for bodies with the same 
name and version. If one is found, the missing body 
is automatically replaced by the body from the other 
directory. If another body is not found, issue the 
use or library command to specify a directory or 
library with an equivalent part. 
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ignore (Return) 


Ignores the current SCALD directory. 


EXAMPLES § 


ignore lsttl 


Ignores the \sttl library. 


ignore practice.wrk 


Removes the SCALD directory practice.wrk from the ac- 
tive search list. 


See Also 
library Adds a library to the active search list. 
use Specifies the working directory on the active search 
list. 


Section 2 (The Editing Environment) of the ValidGED 
User’s Guide explains the file and directory struc- 
tures in GED and includes a discussion of the active 
search list. 
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include Adds items or groups to a specified group. 


clude pt [option] ... 
clude group_name [option] ... 


n 
in 


pt To add individual objects to the current group, press 
the yellow or blue button. To add previously- 
defined groups to the current group, press the white 
button or enter the single-letter group name. 


group_name The name of the current group. Any objects you 
specify are included in the current group. Specify 
the current group by entering the single-letter 
group_name. If you do not specify the group, the 
most recently generated group is used. The 
group_name must be included on the same line as 
the command. 


option Several optional flags allow you to include types of 
objects in a group. The objects are included based 
on their association with objects already in the 


group. 
bodies Include all bodies that have properties already in the 
chosen group. 
connections Include all objects connected to the pins of any body 
already in the chosen group. 
group_name Press the white button or enter the single-letter 


group name to include a previously-defined group 
in the current group. 
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See Also 


exclude 
find 


group 


select 
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Include all nets of wires attached to bodies or wires 
already in the chosen group. 


Include all properties attached to objects already in 
the chosen group. 


Include all wires that have properties already in the 
chosen group. 


Removes objects or groups from a group. 
Allows you to define a group of objects. 


Allows you to define a group by drawing a closed 
polygon around the required objects. 


Provides a stretchable rectangle to specify the 
boundaries of a group. 
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led 


See Also 


connect 
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Compares signal names between logic design and 
layout drawings. (SCALDsystem only) 


led 


This command allows SCALDstar users to compare 
signal names on the logic design to the layout draw- 
ing. The led command is identical to connect led. 


To use the command: 


1 From the GED window, type: 
led 
2 Go to the LED window and type: 
ged 
The two programs are connected. 


This operation must be completed within ap- 
proximately 30 seconds. 


When the show net command is used in either the 
GED or LED window, the net is found and high- 
lighted in both places. 


Provides interprocess communications between GED 
and other processes. 
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library Adds a specified library to a search list. 


library [/ibrary_name] 


SYNTAX 


library_name Adds the specified library to the active search list. 
This allows you to reference parts from the library 
and add them to your design. 


If you enter the command without a library name, 
the command returns a list of the available library 
names. 


library sttl 


EXAMPLES | 


Adds the sttl library of parts to your active search list of 
directories. 


library 


Lists all possible libraries that you can reference with the 
library command. 
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loadmenu 


menu_name 


EXAMPLES [ 


See Also 


menu 
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Read in menu definition files. ( Sun systems only) 


loadmenu [left | right] menu_name 


Load the required menu on the left-hand side of the 
GED screen. 


Load the required menu on the right-hand side of 
the GED screen. The right-side menu is the default. 


If neither left or right is included with a new menu 
name, the new menu is loaded on the same side as 
the current menu position. 


The name of the file containing the desired menu. 
You must include the .menu filename extension. 


The loadmenu command reads in predefined or 
custom menu definition files. The command can be 
typed in the GED message window, or it may be 
included in your startup.ged file so that a specific 
menu is loaded when you enter the editor. 


loadmenu left or loadmenu right without the name 
of a new menu to load moves the current on-screen 
menu to the indicated side of the screen. 


loadmenu left ged.menu 


loadmenu right /usr/catie/mymenu 


loadmenu /usr/valid/tools/editor/menus/pr.menu 


Selects the GED command to be displayed on the 
menu (non-Sun systems). 
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masterlibrary 
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filename 


Allows you to use a file of abbreviations for your 
SCALD directories. 


masterlibrary filename 


The name of the file containing abbreviations for the 
SCALD directories you want to access. 


The masterlibrary command allows you to use ab- 
breviations to refer to your SCALD directories. This 
allows you to specify SCALD directories outside 
your current working directory without entering the 
entire pathname or file specification from GED. 


In your startup.ged file, enter the masterlibrary 
command followed by the name of the file contain- 
ing the abbreviations. 


The default file master.local in your login directory is 
provided for this use. You can, however, create an 
abbreviation table file with any name. In this file, 
specify enough information in the path or file speci- 
fication so that GED can find the appropriate 
SCALD directory when you enter the use command. 


For example, if you often require a SCALD direc- 
tory located on another machine on the network, you 
should specify the machine-rooted path. If the 
SCALD directory is located in another one of your 
project directories, specify the relative path to the 
file. 
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See Also 
ignore 
library 
use 
write 
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Removes the specified SCALD directory from the 
search stack. 


Adds a library to the search stack. 


Adds a specified SCALD directory to the search 
stack. 


Writes the drawing to the current or specified 
SCALD directory. 
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menu 


SYNTAX ff 


number 


pt 


ged_command_word 


See Also 


loadmenu 
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Selects the GED command to be displayed on the 
menu. (Non-Sun systems only) 


menu number ged_command_word 
enu pt ged_command_word 


A number from 1 to 15 to specify the menu box 
position. 


Instead of specifying a menu box position, you can 
point to the required box and press any button. 


The GED command to display in the specified menu 
box position. 


The menu command allows you to select the GED 
commands displayed in the menu. menu com- 
mands can be placed in startup.ged and script files. 
To change the displayed menu: 


1 Issue the menu command. 


2 Specify the menu box position with a number 
or by pointing to the required box and press- 
ing any button. 


3 Type the GED command (abbreviations are 


allowed) and press (Return). 


Reads in predefined or custom menu definition files 
(Sun systems only). 
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mirror Creates a mirrored version of a selected body. 


mirror pt ... 


The mirror command creates a mirrored version of 
a body, as opposed to a rotated version. This com- 
mand mirrors all lines and arcs in a body drawing 
about the Y axis. Justified text is shifted from left 
to right or right to left in the mirrored version. No 
other rotation is done. 


To create a mirrored version of a body included in a 
logic drawing, issue the mirror command and select 
the body to be mirrored with the yellow cursor but- 
ton. 


In a body drawing, mirror flips over the 


entire body definition. This procedure is useful for 
creating other versions of a body. 


For instance, two versions might resemble those in 
Figure 3. 


MIRROR 
BODY.1 a al BODY. 2 


Figure 3. Mirrored Body Versions 
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See Also 
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rotate 


spin 


version 


The mirror command should be used with caution, 
especially with bodies with unmarked pins, such as 
the Valid-supplied merge bodies. Reversing the bits 
causes subtle, hard-to-find errors in the design. 


Rotates a body or text string 90 degrees, with mir- 
rors at 180 degrees and 270 degrees. 


Provides true rotations, not mirrors, of a body. 


Displays alternate representations of a body. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains additional information about adding 
bodies to a drawing, and Section 4 (Design 
Techniques) contains additional information about 
creating body drawings. 
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move Moves objects from one position to another. 


ove source_ pt destination_pt ... 


move group_name destination_ pt ... 


SYNTAX 


source_pt The object to move. 
group_name The group to move. 
destination_pt The new position of the group or object. 


The move command is used to move objects from 
One position to another on the drawing. _ 


Properties (including signal names) attached to ob- 
jects are moved with the objects. Properties can 
also be moved independently of objects. 


If you move an object or group of objects that has 
electrical connections (wires), the move command 
preserves the electrical connectivity and keeps the 
wires orthogonal. 


To use the move command to move single objects: 
1 Select move from the menu. 
2 Position the cursor on the object that is to be 
moved and press the appropriate button. 


e The yellow button picks up the object at 
the grid point nearest the cursor. 


e The blue button picks up the object at the 
vertex nearest the cursor. (The vertex of 
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See Also 
group 
select 
split 
set 
82 


the object snaps to the cursor.) This op- 
eration is useful for moving bodies. 


3 Move the object to its new location and press 
the appropriate cursor button. 


e The yellow button places the object on the 
grid point nearest the cursor. 


e The blue button attaches the object to the 
nearest vertex. 


The move command also operates on defined 
groups. You can specify the name of the group or 
press the green or white button to select the group to 
be moved. 


The window and zoom commands can be nested 
within the move command. 


Defines a group of objects (which can then be 
moved). 


Defines a group of objects (which can then be 
moved). 


Separates objects with common vertices so they can 
be moved. 


set move_direct and set move_orthog change the 
wire mode used by the move command. 
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See Also 
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find 


Displays the items located by the find command. 


next 


The next command steps through the items found 
by the find command. It draws an asterisk at the 
location of the item’s vertex. You can perform an 
operation on the object and then issue the next com- 
mand to proceed to the next item. You can only 
step through the list once. 


If you run the check command, next performs like 
the error command by finding the next error in the 
design. 


Defines a group of items that match a specified 
pattern. 
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note 


SYNTAX = 


See Also 
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text_line 


pt 


filenote 


Adds text strings to a drawing. 


note (text_line ... pt ...) ... 5 


The text to add to the drawing. 
Where each note is to appear on the drawing. 


Notes are text strings that appear on the drawing; 
they do not affect the evaluation of the drawing by 
the SCALDsystem. 


There are two ways to add notes to a drawing: 


e Specify the points on the drawing where the 
notes are to be located and then type in the 
text. Press after each note to posi- 
tion each note on the drawing. As long as 
there are points remaining, GED interprets 
the text you enter as notes to the drawing. 


e Type in each line of text and press (Return). 


(You can enter several strings before placing 
them.) Then use the cursor and the yellow 
button to indicate where each note is to ap- 
pear on the drawing. 


Place quotation marks around notes beginning with 
an open parenthesis. Quoted notes are never inter- 
preted as GED commands. 


The window and zoom commands can be nested 
within the note command. 


Allows you to add a text file to a GED drawing. 
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paint Assigns selected colors to specified objects. 


SYNTAX 


paint color_name group_name 
AMARA ARIAS PADD ROO PDPR ARP AOI mS paint color_name pt 
paint default 


color_name The color to assign to a group or object. 
group_name The single-letter name of the group to color. 
pt To assign a color to an object, point to the object 


and press the yellow button. Select a group by en- 
tering the group name or by pointing to the required 
group and pressing the white button. 


default This command paints objects in their preset default 
colors. Use the set command to establish default 
colors for the objects in your drawings. 


The paint command allows you to assign colors to 
the objects in your drawing. Even if you are work- 
ing on a monochrome monitor, you can add color to 
drawings that can be printed on a color plotter or 
transferred to a color workstation. 


You can use up to 16 colors in a drawing. The 
predefined colors are shown in Table 5. 


Table 5. Predefined Paint Colors 
Red Salmon 
Green Violet 


Blue Skyblue 
Yellow Pink 
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EXAMPLE § 


The find command 
places all \s00 parts it 
finds in the first avail- 
able group name. 


See Also 


set 


show 
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If you have a color monitor, the objects are drawn in 
the actual colors you specify. If you use a mono- 
chrome monitor, you can use the show color com- 
mand to display the names of the colors assigned to 
the objects in your drawing. 


When you issue the paint command, the status line 
is replaced by a list of the available colors. To as- 
sign a color to an object, use the cursor to select a 
color from the menu and then point to the required 
object and press the cursor button again. You can 
also define a group and then assign a color to the 
group. 


The window and zoom commands can be nested 
within the paint command. 


You can establish default colors for the objects in 
your drawings with the set color commands. 


To change the color of all the LS00 bodies in a 
design: 


find 1s00 
paint skyblue "a" 


If you have a color monitor, the colors are dis- 
played on the screen. 


The set color commands allow you to specify a de- 
fault color to be used for each type of object in the 
drawing. 


The show color command lists the color of the 
specified object. 
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paste 


See Also 


1/15/89 


cut 


Copies the contents of a cut buffer to the current 
drawing. 


paste pt ... 


The paste command, used with the cut command, 
allows an object or a group of objects to be copied 
from one drawing to another. To copy a group or 
object that has been cut, type: 


paste (Return) 


and then select the point to position the group or 
object. 


To add more copies of the cut buffer, press the yel- 
low cursor button, position the copy, and then press 
the yellow button again. 


The window and zoom commands can be nested 
within the paste command. 


Copies an object or a group from a drawing toa 
buffer. 
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pause Temporarily interrupts GED until you press a key. 


pause 


This command allows you to temporarily interrupt 
GED until you press another key. This is useful for 
demos and scripts. 


See Also 


sleep Allows you to temporarily stop GED from within a 
Script. 
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pinswap 


SYNTAX § 


pt? pt2 


pin_number 


See the description of the 
PIN_GROUP property in the 
Library Reference Manual 
for information about making 
pins swappable. 
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Swaps the pin numbers defined to be in the same 
pin group on a body. 


pinswap ( pt7 pi2 ) ... 
pinswap pin_number pt ... 


The two pins to be swapped. 


Rather than pointing to two pins, you can type in a 
new pin number and then point to the pin. The se- 
lected pin is swapped with the pin having the pin 
number you specified. 


The pinswap command swaps the pin numbers be- 
longing to the same pin group on a body. This com- 
mand can only be used after section assignment has 
occurred for the part. Also, pin swapping can only 
occur between pins that have been defined in the 
library as swappable. For example, it may be legal 
to swap the two input pins of a NAND gate, but not 
the input and output pins of the gate. 


To swap pins, use one of the following procedures: 


e Type pinswap and point to the two pins to be 
swapped. 


e Type pinswap, type in a new pin number, 
and then point to the pin. The selected pin is 
swapped with the pin having the pin number 
you specified. 


The properties attached by the pinswap command 
cannot be changed, only deleted and moved. Once 
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pins on a part have been swapped, the part cannot 
be resectioned using the section command. 


See Also 
backannotate Annotates the design with physical information from 
the Packager. 
section Displays different sections of a body with pin 
numbers. 
set near_pin, far_pin, rotate, and pin_size control the 
appearance of pin numbers on the drawing. 
90 
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property 
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attach_pt 


group 


name 


value 


location_pt 


Attaches a property name and value to a specified 
vertex of an object. 


property (attach_pt (name value location Pl) 20s) ive 
property (group (name value) ...) ... 


The vertex where the property is to be attached. 


The name of a group. The group name can be typed 
in or a group can be selected by pressing the white 
button. The specified property is attached to each 
object in the group. 


The name of the property. The property name must 
be less than 16 characters long. 


The value of the property. The name and value can 
be separated by a space, an equal sign (=), or can be 
typed on separate lines. 


The location on the drawing where the text of the 
property value should appear. 


Properties allow you to associate information with 
selected objects on a drawing. The information is 
passed to other design programs for processing and 
analysis. A property consists of a name-value pair 
that is attached to an object: a body, pin, wire, or 
signal name. 


Property names can be any string of alphanumeric 
characters and underscores, provided that the first 
character is an alphabetic character. A property 
name cannot contain any spaces or punctuation ex- 
cept for the underscore. 
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The property value can be any string of text, includ- 
ing spaces and marks of punctuation. As described 
in the SCALD Language Reference Manual, there are 
no restrictions on the use, names, or values of prop- 
erties. Certain kinds of properties, such as SIZE, 
are known to GED and are handled in a consistent 
manner. Properties that are not known to GED are 
passed to other processors such as the Compiler and 
Timing Verifier. 

Each property attached to a given object (except the 
SIG_NAME property) must have a unique name. If 
a newly entered property has the same name as a 
property currently attached to that object, the new 
property value replaces the old property value. 


To specify a property: 
1 Select property from the menu. 


2 Specify the object (vertex) or group where 
the property is to be attached. 


3 Type the name and value of the property. 
The name and value can be separated by a 
space or an equal sign (=), or typed on sepa- 
rate lines. 


4 Specify the location on the drawing where the 
text of the property value should appear. 
The placement is automatic when properties 
are assigned to groups. 


When a property is added to a drawing, only the 
property value appears. The show properties com- 
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See Also 
copy 


delete 
display 
move 
reattach 


set prop display 


show attachments 


show properties 


signame 


swap 
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mand temporarily displays the names and values of 
all properties on the drawing. The display com- 
mand changes the permanent display of property 
name and value pairs. The set prop_display com- 
mand controls the display of added properties. 


You can manipulate the properties you add to a 
drawing with the swap, reattach, copy, move, and 
delete commands. Default body properties and the 
properties produced by the pinswap, section, and 
backannotate commands cannot be manipulated. 


The window and zoom commands can be nested 
within the property command. 


Copies objects, properties, and groups in the current 
drawing. 


Removes objects from a drawing. 

Changes the way objects are displayed on a drawing. 
Moves objects from one position to another. 
Reattaches properties from one object to another. 


Changes the default values controlling the display of 
properties on the drawing. 


Displays the connections between properties and the 
objects to which they are attached. 


Displays the name and value of the properties on the 
drawing. 


Attaches signal names to wires or pins. 


Swaps the position of two properties. 
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quit Allows you to end the editing session. 


quit 


This command terminates an editing session. GED 
displays a message if there are unwritten changes to 
the drawings in the current editing session. Issue 
the quit command twice in succession to override 
the warning, discard all changes, and terminate the 


session. 
See Also 
exit Allows you to end the current editing session. Same 
as quit. 
write Writes the current drawing to the disk. 


94 1/15/89 


GED Commands 


reattach 


See Also 


move 


show attachments 


1/15/89 


Reattaches properties from one object to another. 
reattach pt7 pt2 ... 


The reattach command reattaches properties (in- 
cluding signal names) from one object to another. 
For example, you can use the reattach command to 
attach a property from the input pin of a part to the 
output pin. 

To use the reattach command: 

1 Type: 
reattach 


and select the property to be moved. A line 
is drawn from the property to the current cur- 
sor position. 


2 Specify the new attachment point for the 
property. 


3 Use the move command to position the prop- 
erty closer to its new attachment point. 
Default body properties and those produced by the 
backannotate, pinswap, and section commands 
cannot be reattached. An error message is dis- 


played when you attempt to reattach one of these 
properties. 


Repositions the selected object. 


Allows you to verify that the properties you reat- 
tached are attached to the correct objects. 
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redo 


SYNTAX | 


See Also 


undo 
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Reverses the last undo command. 


redo 


The redo command undoes the previously issued 
undo operation. The SCALDsystem keeps a list of 
operations performed during the current editing ses- 
sion in a log. The undo and redo commands per- 
form their functions according to the log. 


Undoes the previous changes made to a drawing 
during the current design session. 
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remove Deletes a drawing from a SCALD directory. 


remove [<dir>] [drawing_name} [. [type] [. [version] [.[ page] ]}] 


<dir> The SCALD directory where the drawing resides. 
drawing_name The name of the drawing to remove. 
.type.version.page The drawing type, version number, and page of the 


specified drawing. 


This command deletes a drawing from a SCALD di- 
rectory. Because you can specify only one argument 
with the remove command, repeat the procedure to 
delete additional drawings. To delete a drawing: 

1 Type: 


remove 


and the name of the drawing to be deleted. 
Wild cards can be used in the drawing name. 


2 Press (Return). 


GED displays the names of the files to be 
deleted. 


3 Select the semicolon from the GED menu or 
type: 
; (semicolon) 


The directory entries are deleted, and the 
files are purged. 
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To cancel the remove command, type: 


spore 


or select any command except semicolon from the 
menu. GED displays the message: 


Nothing done 


Wild cards are allowed in the file names specified in 
the remove command. An asterisk (*) matches 
anything, and a question mark (?) matches any sin- 
gle character. 


If just the drawing name is specified, remove de- 
letes all drawing types (BODY, LOGIC, SIM, etc.), 
versions, pages, and files (ASCII, binary, depend- 
ency, connectivity) of the specified drawing in the 
SCALD directory. 


If no SCALD directory is given, remove searches 
for the specified drawing in the currently active 
SCALD directory. 


remove drawing1 


Deletes all drawing types (SIM, LOGIC, BODY) of 
drawing1. 


remove drawing2. logic. * 


Deletes only the LOGIC pages of drawing2. 


remove drawing38.logic.*.1 


Deletes only the first page of the LOGIC drawing, 
drawing3. 
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replace Substitutes one part for another. 


replace body_name[.body] [.version] pt ... 


replace body_name[.body] [.version] group_name 


body name The name of the body drawing to be replaced. 
.body The type BODY can be specified, but is not re- 
quired. 
version The version defaults to 1, but any existing version of 


a body can be replaced. 


group_name The name of the group to be replaced. This is use- 


ful for global changes if you have placed all of one 
type of part into a group. 


The replace command is used to substitute one part 
for another. There are several ways to use the 
replace command: 


e Enter the name of the replacement part, then 
use the cursor to point to the body or bodies 
to be replaced. 


e Select the bodies to be replaced with the cur- 
sor, then enter the name of the replacement 
body at the keyboard. Each body you se- 
lected with the cursor is replaced by the 
specified body. 


e Use the find command to group all the occur- 
rences of a body to be replaced, then use the 
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add 


find 


version 


group_name option with the replace com- 
mand to globally change all the occurrences 
of the body. A message displays the number 
of bodies that are replaced. When you re- 


place the bodies in a group, enter a 
before you type the group name. 


Pin properties are reattached if a pin name on the 
new part is the same as a pin name on the first part. 
If the pin names do not match, the pin property be- 
comes a body property. 


All properties except those generated by the 
backannotate, section, and pinswap commands 
are kept. All default properties that have a value of 
“2” receive the value of the property with the same 
name on the replaced body (if one exists). Wire 
connections to the original part are kept only if the 
pins are in the same location. The rotation of the 
original body is preserved when the body is 
replaced. 


Adds a specified drawing to the body. 


Defines a group of items that match a specified 
pattern. 


Selects an alternate version of a body. 
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return 


See Also 
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show history 


show return 


Returns to the previously—edited drawing. 


return 


This command causes GED to return to a previ- 
ously-edited drawing. If the current drawing is 
modified but not written, the system saves a copy of 
that drawing before returning to the previous 
drawing. 


Lists the drawings that you edited during the current 
session. 


Lists the drawings that the return command will re- 
turn to in the order that they will be accessed. 
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rotate 


SYNTAX 


See Also 
add 
mirror 
spin 
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Rotates a body or text string 90 degrees, with mir- 
rors at 180 and 270 degrees. 


rotate pt ... 


The rotate command creates rotated and mirrored 
versions of a selected body. When a body is ro- 
tated, all properties are also rotated. Text strings 
can be also rotated or justified independently. 


To rotate a body or text string, type rotate and then 
point to the object to be rotated. Each time you 
press the button, the part rotates 90 degrees. In the 
90 degree rotation, body notes are rotated 90 de- 
grees and left in their original justification. 


Rotating some parts 180 degrees reverses the order 
of the pins. This can cause subtle errors in your 
designs if pins become incorrectly wired. Therefore, 
a 180 degree rotation of a part becomes a mirror of 
a 0 degree rotation (about the Y axis). A 270 de- 
gree rotation of a part is a mirror of a 90 degree 
rotation (about the X axis). . 


For the mirrors, justified text is shifted from left to 
right or right to left, and no further rotation is done. 
Text rotations (properties and drawing notes) are ac- 
tually rotated, not mirrored. 


Bodies are rotated during the add command when 
you press the white button. 


Creates a mirrored version of the selected body. 


Provides true rotations, not mirrors, of a body. 
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route Draws a wire connecting two selected points. 


route pt pt ... 


The route command connect two points by drawing 
a series of orthogonal line segments between them. 
If it cannot determine a route, it draws a diagonal 
line directly between the two points. route will not 
run a wire through any existing objects or vertices. 


To select the nearest pin or wire vertex for a route 
point, use the blue button to select the point. Use 
any other button to select the nearest grid point. 


Points to be routed Resulting route 


Figure 4. Route Command Operation 


See Also 
wire Adds individual wires to a drawing. 
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nds 


scale 


SYNTAX ff 


pt? pt2 


drawing_name 


See Also 
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format 


smash 


Smashes a drawing and includes it in the current 
drawing. 


scale ( pt? pt2 ) drawing_name 


Indicate the size of the rectangle where the smashed 
drawing will be placed. 


The name of the drawing to smash and add to the 
current drawing. 


The scale command adds a specified drawing to the 
current drawing in the rectangle indicated by two 
points. The drawing is smashed (all bodies are 
turned into wires, arcs, and text). scale is useful 
for doing documentation drawings. 


When a drawing is smashed, all connectivity infor- 
mation is lost. The drawing can no longer be inter- 
preted by the Compiler. 


Combines a text file with referenced drawings. 


Breaks a body into the objects that define it. 


Section 7 (Mixing Text and Graphics) of the ValidGED 
User’s Guide contains more information about creat- 
ing mixed text and graphics documents. 
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script 
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filename 


$< 


Performs the GED commands listed in the specified 
text file. 


script filename 


The name of the script file to execute. 


The script command allows you to specify GED 
commands in a script file. This allows you to oper- 
ate in batch mode using the same syntax as if you 
typed in the command. You can use the cursor con- 
troller to enter points or you can specify the X-Y 
coordinates in the script file. 


startup.ged is a good example of a script file. This 
special file is expected by GED as an initialization 
script. If that file does not exist, a warning message 
is displayed when GED begins. 


You can configure a script to accept input during 
execution by including user input tokens in a script. 
User input tokens must be placed at the beginning 
of a new line. There are two user input tokens: 


When GED encounters this token in a script, it 
prints from the token to the end of the text line as a 
prompt in the message window, then waits for one 
item of input. The input can be a typed line, a func- 
tion key press, a cursor controller point, or a 


(ControJ-C; you cannot use a as a re- 


sponse to a user input request. 


This token also prints from the token to the end of 
the text line as a prompt and awaits input, but this 
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token accepts and interprets input until you enter a 
semicolon. If this token is included, GED follows 
the prompt with the message: 


Type ; when done with user input. 


When GED sees a user input token in a script, it 
highlights a menu button with the name of the GED 
command being executed. 


To abort a script, enter (Contra) -C. To abort at a 


user input token prompt, enter a semicolon. 


add 1s04 
$<Place the LS04 


EXAMPLES f 


Add a single LSO4 to a drawing and use the mouse to posi- 
tion the part. 


property 

$<Choose the part to add a size to 
size = 

$<Type in the size you want 

$<Place the property on the drawing 


Add a Size property to a part with a size specified at the time 
of entry. 


rotate 
$;Rotate the object until properly oriented 


Rotate an object until the user enters a semicolon. 


A more complicated script might contain a large 
number of signame commands and prompt the user 
for a point to place each SIG_NAME property. 
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section 
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pin_number 


Displays different pin numbers for different sections 
of a body. 


section [ pin_number | pt ... 


The pin number that defines the section. 


The section command allows you to assign a physi- 
cal part section to a selected logical part. As you 
step through the different sections of a body, the pin 
numbers of each section are displayed on the draw- 
ing. Sectioning a part automatically assigns path 
properties to the drawing. 


If the logical part selected can be assigned to a sec- 
tion, the pin numbers for the section are displayed 
on the drawing. If the same part is selected again, 
the next section is selected and the new pin numbers 
are displayed. Thus, by pointing to the same part, 
you can step through all the different possible 
sections. 


To assign a specific section directly, type in a pin 
number that uniquely defines the section and then 
point at the part. This avoids stepping through each 
section individually. 


Currently, you can only section parts with SIZE = 1 
or HAS_FIXED_ SIZE characteristics. Assigning 
sections to a HAS FIXED SIZE part is accom- 
plished by pointing to the pin of the section to be 
assigned. 


The section command uses the information in the 
library’s chips file to display the pin numbers. You 
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See Also 
backannotate 
pinswap 
sei 
108 


can only perform section on parts from libraries 
with this file. 


To remove section information from a part, use the 
replace command to replace the sectioned body 
with a new copy of the part. 


Annotates the design with physical information from 
the Packager. 


Swaps pin numbers on a body that are defined to be 
in the same pin group. 


Severai options controi the placement of pin num- 
bers on the drawing. 


Section 6 (Adding Physical Information) of the 
ValidGED User’s Guide contains more information 
about the chips_ prt file. 
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select 


group_name 


all 


pt? pt2 


See Also 


exclude 


find 


group 


include 
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Provides a stretchable rectangle to specify the 
boundaries of a group. 


select [group_name] [all] pt? pt2 ... 


A single-letter name for the group. Do not enclose 
the group name in quotation marks. The group 
name is optional. 


Places the entire drawing into the group. 


Defines the boundaries of a group. Use the cursor 
and the yellow button to position a stretchable rec- 
tangle around the objects to be included in the 
group. You can also press the blue button to in- 
clude individual objects in the same group. 


You continue to add objects to the same group until 
you enter another command or a semicolon. 


The window and zoom commands can be nested 
within the select command. 


Removes items from a group. 


Defines a group of items that match a specified 
pattern. 


Allows you to define a group of objects by defining 
a closed polygon. 


Adds objects or groups to a group. 
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option 


dependency 
noascii 
nobinary 
noconn 


nodependency 


capslock off 
capslock on 


center_ justified 
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left_ justified 


right_ justified 


Establishes the default options for GED. 


set option 


The set command modifies the default command 
options used by GED. The commands can be issued 
during an editing session or placed in the startup.ged 
file. 


set has many options that allow you to tailor GED 
to your particular requirements: 


Lists the current settings and options. 
paar is saved. Default files are: 
e ASCH e Connectivity 
e Binary e Dependency 
Unwanted files can be turned off emperny and 


then reset. 


capslock_off allows GED to interpret all input as it 
is entered at the keyboard (default). capslock_on 
allows GED to interpret all input as uppercase re- 
gardless of how it is entered at the keyboard. Only 
affects text added to a drawing. 


Sets the justification of text strings (properties and 
notes). The default is left—justified. 
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check_on write off Determines whether the check command is auto- 
check_on_write on matically called by the write command. The default 


is check_on_write on. 


color_arc color Sets the default color for new objects of the speci- 
color_body co/or fied type. The default for all objects is monochro- 
color_dot co/or matic. The color can be one of the following: 
color_note co/or 
color prop color e Aqua e Pink 
color_wire co/or e Blue e Purple 
e Brown e Red 
e Green e Salmon 
e Gray e Skyblue 
e Mono e Violet 
e Orange e White 
e Peach e Yellow 
decimal decimal bases drawings on the decimal system, with 
fractional 500 internal units per physical inch. The grid spac- 
metric ing on the status line of the display is in grids—per- 


inch. fractional sets the default internal division of 
500 units per inch to 400 units per inch. Valid li- 
braries remain compatible, with bodies 25% larger 
and pins on 1/8 inch centers. metric bases draw- 
ings on the metric system with 508 internal units per 
inch, or 20 internal units per millimeter. The grid 
spacing on the status line of the display is in grids- 
per-millimeter. This remains compatible with Valid 
libraries since pins are on 2.5 mm centers. 
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default _doc_grid options 
default grid options 


See the grid command 
for more information on 
default grid options. 


direct wire 
orthog_ wire 


dots filled 


dots open 


single_width 


double_ width 
i 


far_pn 


near_pn- 
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The default_grid command changes the default 
grid. default_doc_grid changes the default grid for 
DOC drawings. The available options for both com- 
mands are the same as those for the grid command: 


e on e grid_multiple 
e off e dots 
e grid_size e lines 


The default is grid size is 0.1. The grid for BODY 
drawings is 1/2 the default grid setting (initially 
0.05). The initial grid for DOC drawings is 0.166. 


orthog wire sets the wiring mode to orthogonal 
(right-angle bent) wires. Orthogonal mode is the 
default. The direct_wire option sets the wiring 
mode to non-orthogonal (diagonal) wires. 


dots_open displays added dots as small open cir- 
cles (default). dots_filled displays filled (solid) 
dots. 


Governs the darkness of plotted lines. The default is 
double width, which prints two pixels instead of 
one. 


Controls the placement of pin numbers on the draw- 
ing. far_pn (default) places numbers slightly fur- 
ther from the pin than near_pn. 


f 
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font font_name 
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go _at_pin 
stop_at_pin 


Allows you to specify the text font to be used in the 
hard copy of the drawing. The following fonts are 
available: 


e vector_font (default) 
e native font 

e gothic font 

e milspec_font 

e cursive font 

e valid font 

e greek_font 

e symbol_font 

All text in the drawing is set in the same font. Non- 


default fonts are available only in hpr mode. 


go_at_pin continues the wire from a pin. You must 
press the yellow cursor button twice to end the wire. 
stop_at_pin ends a wire when the blue button is 
used or when the yellow button is used at a pin, dot, 
wire endpoint, or T-junction (default). 


Controls whether or not the grid is displayed when 
GED is entered and when new drawings are edited. 
The default is off. 


Plots using hpfilter. vgb plots using the mono- 
chrome $32 display. 
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local_plot Determines whether plot spooling is immediate (lo- 
spooled_plot cal) or delayed (spooled). The spooled option cre- 
ates a plot file, vw.spool, for the type of plotter speci- 

fied with the set command. 


mono hpplot Uses hpfilter to plot to a Hewlett-Packard plotter. 
move_direct move_orthog uses orthogonal (bended) wires when 
move _orthog an object is moved (default). move_direct uses di- 


agonal wires when an object is moved. 


nfs_file_ locking off Allows the System Manager to determine whether 
nfs_file locking on GED honors network locks. nfs_file_locking on en- 


ables network-style locks. nfs_file_locking off tells 
GED to use flock locks only. The default is off. 


pin_size scale Changes the size of added pin numbers. The scale 
can be set to any real number. The default is 0.80. 


plotter plotter_name Allows you to specify the name of a plotter sup- 
ported by hApfilter. The default is an 11-inch Ver- 
satec. You can also plot to a file that conforms to 
the graphics standards for the Interleaf publishing 
software. For example: 


e wiiversatec (default) 
e interleaftps 


For a full listing of the plotters supported by your 
system, see the appropriate system administration 
manual. 
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prop display display 


push_type drawing_type 


size scale_factor 


sticky_off 
sticky _on 


user editor editor_name 


user_sim simfile 
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Specifies the default visibility of properties you add 
to a drawing. The display options are: 


e both ® name 


e invisible e value (default) 
Specifies the drawing type for edit when the draw- 
ing extension or type is missing. The default is 
LOGIC. This is also used by the edit and get com- 
mands when you specify a drawing to edit by select- 
ing a body with the cursor. 


Determines whether numbers annotated to vertical 
pins are rotated. The default is rotate on. 


Changes the default size of entered text. The de- 
fault text size is 0.082 inches (size 1). The maxi- 
mum height is 2 inches, or size 24. 


If a default property is deleted from a BODY draw- 
ing, sticky_off deletes the property from a LOGIC 
drawing when it is read into GED (default). 
sticky_on converts default body properties into 
non-default properties on a LOGIC drawing. 


Specifies the editor to be used in the v mode of the 
change command. The default editor is vi on UNIX 
systems and EDIT/EDT on VMS systems. 


Allows you to specify the UNIX pathname or VMS 
file specification of an alternate Simulator 


executable. 
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show 


SYNTAX 


option 


show 


attachments 
body_name pt 


color pt 


coordinate pt ... 
connections 


distance pt? pt2 
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Temporarily displays the specified drawing 
information. 


show option 


The show command displays classes of objects. 
The effect of the show command is temporary; in- 
formation displayed with this command disappears 
when the drawing is written to the disk file or when 
the screen is redrawn. 


show has several options: 
Displays a list of all the show options. 


Displays the connections between properties and the 
objects to which they are attached. 


Displays the name, version, angle, and SCALD di- 
rectory of the indicated part. 


Lists the color of the specified object. 


Displays the internal GED coordinates of an indi- 
cated point. 


Displays an asterisk at each wire connection in the 
drawing. 


Displays the distance between two indicated points 


in the drawing area. If set decimal or set frac- 
tional mode is set, the unit of measure is inches; if 
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group [ pt ] 
group [group_name] 


history 


keys 


modified 


net [ pt] 
net [net_name] 


origins 


pins 
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metric mode is set, the unit of measure is millime- 
ters. Use the yellow button to specify an actual lo- 
cation on the screen, the white button to specify the 
nearest grid point, or the blue button to specify the 
nearest vertex. 


Causes the specified group to be highlighted. You 
can either select the nearest group with the cursor or 
type the name of the group. 


Also, the show group command lists the number of 
bodies, notes, properties, dots, arcs, and wires that 
the group contains. 


Lists all the drawings you edited during this GED 
session and shows which are modified but unwrit- 
ten. show history also lists the drawing you will 
edit with the return command. 


Lists the function keys and the corresponding text 
string that has been assigned to each key. 


Lists all the drawings you have modified but not 
written during this GED session. 


Highlights all nets matching the name of the se- 
lected or specified net. The net can be specified by 
name or by pointing to a net with the cursor. 


Displays asterisks at the origins of bodies on the 
drawing. 


Displays the pin connection points on bodies. 
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properties 
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Shows both the name and value of all of the proper- 
ties on the drawing. Since signal names are handled 
internally as properties attached to wires, the use of 
show properties displays the text 


SIG_NAME= 


with each signal name. 


Lists the UNIX or VMS directory from which the 
current GED session originated. 


Displays the release version information for GED. 


Displays, in order, the previously-edited drawings 


7 es e 
rAtiiyA a 
u can visit with the return command. 


Shows the amount by which the display size of the 
characters in the indicated text string has been 
modified. This size is the multiple of the default 
text size (0.082, unless a set option has been used 
to change the default). 


Displays the pin names from the body definition of 
the indicated part. 


Displays asterisks at the vertices of all objects. 
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signame Attaches signal names to wires or pins. 


signame (signal_name ... pt...) ... 


signal_name The text for the signal name. 


The signame command allows you to attach signal 
names to wires or pins. To attach a signal name: 


1 Select signame from the menu. 


2 Use the cursor to identify the location for 
each signal name. An asterisk is drawn at 
each location. 


3 Type the text for the signal name. 


4 Press : 


Alternately, you can issue the command, type in one 
or more signal names, and then specify points to 
place the signal names on the drawing. 


The signal name is attached to the wire or pin that is 
closest to the specified point. 


Internally, GED handles signal names as properties. 
For example, attaching a signal called 


BUS ENABLE 
to a wire is equivalent to attaching a property 
SIG_NAME=BUS ENABLE 


to that wire. When signame is used to name pins in 
BODY drawings, they are stored as properties with 
the name PIN_NAME. 
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The window and zoom commands can be nested 
within the signame command. 


See Also 


busname Provides a shorthand for naming signals in buses or 
pins on bodies. 


property Attaches a property name and value to an object. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains more information about properties 
and signal names. The SCALD Language Manual 
contains details about signal name syntax. 
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simulate 


root_drawing 


The Simulator is optional 
software and may not be 


included with your system. 


See Also 


1/15/89 


Allows you to run the Simulator program. 
simulate [root_drawing] 


When you run the simulate command, the default 
drawing (the one listed in your simulate.cmd file) is 
simulated unless you provide the name of another 
drawing to simulate. 


The simulate command is used to simulate the func- 
tional behavior of a drawing. The simulate com- 
mand creates a Simulator window in the lower por- 
tion of the screen and establishes communication 
with the GED window. You can use the Simulator 
OPEN command and then select signal names from 
the GED window. 


To exit from the simulator, type EXIT in the simula- 
tor window or endsim in the GED window. 


The ValidSIM Reference Manual contains a thorough 
discussion of the Simulator program. 
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Stops GED for a specified number of seconds. 


sleep seconds 


seconds The number of seconds to pause. 


The sleep command pauses GED for the specified 
number of seconds. This command is useful in 
scripts and demos. 


See Also 


pause Stops GED until a key is pressed. 
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smash Breaks a body into the objects that define it. 


| SYNTAX smash group_name ... 
POAT TNR LSI TERNF UL PSST ETT ENT TINT ETS sm a sh p t pee 
group_name You can either select the nearest group with the cur- 


sor or type the name of the group. 


The smash command breaks a body into separate 
lines, arcs, and notes. Any properties attached to 
the body are deleted. The smash command is use- 
ful for creating library body drawings. You can use 
this command on bodies and groups of bodies in the 
drawing. 


You can create a 3-input AND gate from a 2-input 
AND gate with the following commands: 


EXAMPLE § 


1 edit user 3and. body 
2 add 2and pt 
3 smash pt 


4 Attach the additional input pin and add 
pin_names and dots. 


5 Write the drawing. 


Normally, you cannot add a body to a body drawing. 
Using the smash command changes the 2AND body 
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into its separate elements so that GED does not in- 
terpret it as a body when the USER 3AND drawing 


is written. 
See Also 
add Adds a body to a drawing. 
scale Smashes a drawing and adds it to the current 
drawing. 
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See Also 
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mirror 


rotate 


Provides true rotations, not mirrors, of a body. 


spin pt ... 


The spin command is used when a true rotation of a 
body is needed. This command rotates the body 0, 
90, 180, and 270 degrees without mirroring any of 
the four representations. This reverses the pins on 
some bodies, which can cause errors in the drawing. 
spin also rotates text strings. 


Creates a mirrored version of a selected body. 


Rotates a body or text string 90 degrees with mirrors 
at 180 and 270 degrees. 
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split Adds a segment to an existing wire and separates 
objects with common vertices. 


split pt? pt2 ... 


SYNTAX § 


The split command can be used to perform two 
functions: 


e Split a single wire into two wires by adding a 
vertex along that wire. 


e Separate objects that have been placed at the 
same vertex. 


For example, the split command can be used to dis- 
connect a wire from one pin and move it to a differ- 


ent pin. 


To split a single wire into two wires: 


1 Select split from the menu and select a point 
along the wire with the yellow button. 


This adds a vertex along the wire segment 
between the original two vertices. 


2 Move the vertex to the new location. 


3 Place the new vertex by specifying a second 
point with the cursor. 
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To disconnect items that are placed at the same 
vertex: 


1 Select split from the menu and select the de- 
sired vertex with the cursor (press the blue 
button). 


The selection attaches one of the objects to 
the cursor so it can be moved on the screen. 


2 To move another object, select the original 
vertex again and pull off the second object. 


You can continue to select objects at that ver- 
tex until the correct item has been selected. 


3 Place the object at a new location by moving 
the cursor and pressing the appropriate 
button. 


When all the objects have been split off the 
vertex, select the vertex one more time to 
place down the last item and begin the cycle 
again, splitting off each item in turn. 
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swap 


SYNTAX =f 


See Also 
note 
pinswap 
property 
128 


Exchanges the position of two lines of text (proper- 
ties or notes). 


swap pt7 pt ... 


The swap command is used to swap two properties 
or two notes. Only two notes or two properties can 
be swapped, not a note and a property. Default 
properties and those generated by the pinswap, 
backannotate, and section commands cannot be 
swapped. 


Adds notes to a drawing. 


Exchanges the pin numbers assigned to a body by 
section. 


Attaches properties to objects in a drawing. 
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system Allows you to access the operating system. 


system [command] 


command A system command to execute from within GED. 


The system command allows you to access the op- 
erating system on your system. If you just enter 
system (Return)}, you are connected to the operat- 
ing system and can run any operating system 
commands. 


To exit from the operating system and return to 


GED, type: 
UNIX: (Controd)-D or exit 
VMS: logout 


This command is identical to the unix command. 
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undo Undoes the operation of the previous command af- 
fecting the drawing. 


undo 


The undo command undoes the previous operation 
affecting the drawing. GED keeps a list of opera- 
tions performed during the current editing session. 
Repeated applications of undo reverse the effects of 
events according to this list. Each read or write of a 
drawing causes the undo log to be reset; therefore, 
undo cannot undo operations on drawings earlier 
than the last read or write. 


redo Reverses the last undo command. 
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unix 


command 
UNIX: 
VMS: 
See Also 
system 
1/15/89 


Allows you to access the operating system. 
unix [command] 


A system command to execute from within GED. 
After the command is executed, the system displays 


a prompt instructing you to press (unless 


the command is executed from a script). 


The unix command allows you to access the operat- 
ing system on your system. If you enter 


unix 


you are connected to the operating system and can 
run any operating system commands. 


To exit from the UNIX shell and return to GED, 
type: 


exit 
logout 


This command is identical to the system command. 


Accesses either the VMS or UNIX operating system 
from GED. 
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directory_name 


Specifies a working directory. 
use directory_name 


The name of the SCALD directory to use. If the 
SCALD directory you specify is in a directory other 
than the current directory, the UNIX pathname or 
VMS file specification must be given. 


The use command allows you to specify a SCALD 
directory from which you can retrieve drawings and 
in which you can store drawings. This directory is 
placed at the top of the active search list and be- 
comes your current working directory. There is no 
limit to the number of directories that can be in use 
at one time. 


The masterlibrary command allows you to refer to 
SCALD directories by abbreviations. You place the 
pathnames or file specifications and abbreviations 
for SCALD directories in an abbreviation table file. 
Place the masterlibrary command and the name of 
the abbreviation file in your startup.ged file. Then 
when you use the file during a GED session, you 
can specify just the short file name. 


1/15/89 


GED Commands 


See Also 


directory 


ignore 


library 


masterlibrary 
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use /u0/job/partl1.wrk 


Specifies the SCALD directory parti.wrk in the UNIX 
directory /u0/job. 


use projectl.wrk 


Specifies the SCALD directory projecti.wrk in the cur- 
rent working directory. 


use connectors 


Accesses the SCALD directory associated with the ab- 
breviation connectors. 


List the contents of the active SCALD directories. 


Deletes the specified directory or library from the 
active list. 


Specifies the component library to be accessed. 


Specifies the name of an abbreviation file with the 
pathnames or file specifications and abbreviations 
of SCALD directories. 


Section 2 (The Editing Environment) of the ValidGED 
User’s Guide explains the file and directory struc- 
tures of GED. 
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vectorize Creates a file in vector plot format of the current 
drawing. 


vectorize 


SYNTAX 


The vectorize command creates a file called 
vector.dat that contains the current drawing in vector 
format. This file can be used to transmit files to 
other machines or drive a pen plotter (with the aid 
of a format conversion program). 


See Also Appendix A of the ValidGED User’s Guide contains 
more information about vector plot format. 
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version 


1/15/89 


SYNTAX § 


eaPshaPatatetetaretetateterateteatetstatstarateteteatatatetevatetatatetatet 


group_name 


Selects an alternate version of a body. 


rsion group_name ... 


ve 
version pt ... 


You can use the find command to group all occur- 
rences of a specified body, then issue the version 
command with the group_name option to globally 
change the drawing. The white button changes the 
version of the bodies in the group closest to the 
cursor. 


The version command allows you to select alternate 
versions of appropriate bodies. Some bodies can be 
created with several different symbolic representa- 
tions. For example, the NAND gate is equivalent to 
an INVERT-OR gate by DeMorgan’s Theorem. 
Similarly, a NOR gate is equivalent to an INVERT- 
AND gate. The versions of a body all refer to the 
same logic drawing. 


To step from one representation of a body to an- 
other, issue the version command and then select 
the body with the cursor. GED determines which 
version of that body is currently displayed and re- 
places it with the next version in the sequence. 


Continue to press the appropriate button to cycle 
through all the available versions. After the last ver- 
sion of the sequence is displayed, the first version is 
redisplayed. 


Note that size-wide versions of bodies are repre- 
sented. The first version is sizeable; you can specify 
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the number of bits the part can represent. This ver- 
sion is generally used in structured designs. The 
second version is a flat representation of the part; 
each pin on the drawing represents a pin on the 
physical package. This version is generally used in 
flat designs. 


See Also 


add Allows you to add a specific version of a body di- 
rectly to a drawing. 


replace Substitutes one device for another. 
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window Changes the view of the current drawing. 


SYNTAX 


window [option] ; 


The window command is used to change the view of 
the drawing on the screen. This command can be 
used with up to three arguments. If there are fewer 
than three arguments, the command must be termi- 
nated with a semicolon. You can either select the 
semicolon box from the on-screen menu with the 


cursor or type a semicolon followed by a (Return). 


option The window command options are shown below: 


window ; If you issue the window command followed by a 
semicolon, GED redraws the image without chang- 
ing the center or the scale. This option refreshes the 
screen when error messages cover part of the 
drawing. 


window down Reposition the center of the screen down below the 
drawing (move the drawing up on the screen). 


window fit Fits the drawing to the entire screen. 
window in Enlarge the size of the drawing on the screen. 
window left Reposition the center of the screen to the left of the 


drawing (move the drawing right on the screen). 
window out Reduce the size of the drawing on the screen. 


window previous Switch from the current window scale and position 
to the previous window scale and position. 
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window pt The window command with an argument of one 
point pans the drawing and causes that point to be- 
come the center of a new screen display of the draw- 
ing. The scaling of the drawing remains the same. 
Use the blue button to enter the single point. 


window pt7 pt2 The window command with an argument of two 
points defines a rectangle with the specified points 
at opposite corners. The rectangle expands to fill 
the screen, providing a close-up view of the speci- 
fied portion of the drawing. 


window pt7 pt2 pt3 You can issue the window command with three 
points. The first point defines the new center of the 
drawing and the display becomes either larger or 
smaiier, depending on the ratios of the distances be- 
tween the other points. If the distance between pt/ 
and pt3 is greater than the distance between pt] and 
pt2, the items appear larger; if the distance is 
smaller, items appear smaller. 


window right Reposition the center of the screen to the right of the 
drawing (move the drawing /eft on the screen). 


window scale_factor You can specify an integer or a real number as the 
argument to the window command to scale the view 
of the drawing by the amount entered. The center 
of the window remains the same. 


window up Reposition the center of the screen up above the 
drawing (move the drawing down on the screen). 


Some of the window commands may be pre- 
assigned to function keys, depending on your 
system. 
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window 2 


Makes the drawing appear twice as large. 


window -2 


Reduces the drawing by a factor of two. 


window 1.5 


Enlarges the drawing one and a half times. 


window 0.5 


Has the same effect as window -2. 


See Also 


zoom Also allows you to enlarge and reduce portions of 
the drawing. 


Section 1 (GED Overview) of the ValidGED User’s 
Guide contains more information about function key 
assignments, and Section 3 (Creating a Design) con- 
tains more information about window and display 
functions. 
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wire Adds wires to a drawing. 


wire pt pt... 


SYNTAX 


The wire command is used to add wires to a draw- 
ing. The wire begins at the first point specified and 
runs to the second. Additional points are specified 
to draw a wire with one or more segments. 


To snap the wire to the nearest vertex, press the 
blue button. To end a wire at a pin, dot, or other 
wire, press the yellow button. To end a wire in a 
free space, press the yellow button twice at the final 
point. 


The set commands set stop _at_pin and set 
go_at_pin allow you to specify the default method 
for ending wire segments. 


Because schematics almost exclusively use orthogo- 
nal wires, the default wire mode is orthogonal 
(bent). Once the wire is started and the cursor 
changes direction, the attached wire remains or- 
thogonal, whether the cursor is moved horizontally, 
vertically, or diagonally. To bend a wire, press the 
yellow button. Press the white or green button to 
change the orientation of the bend. If the white but- 
ton is pressed a second time, the wire becomes di- 
agonal. A third press returns the wire to the first 
orthogonal position. 


The set direct_wire command can be typed at the 
keyboard or added to your startup.ged file. In this 
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See Also 


display 


route 


set 


show connections 


1/15/89 


mode, finishing a wire segment with the yellow or 
blue button creates a diagonal wire. Ending a wire 
with the white or green button creates orthogonal 
wire segments to the nearest grid point. You can 
return to the automatic orthogonal wiring mode by 
entering the set orthog mode command. 


To indicate wire connections, you can use the dots 
or auto dots command. In GED, a T-junction is 
automatically a connection whether or not it is dot- 
ted. A four-way intersection (+) is not a connection 
unless it is dotted. 


The window and zoom commands can be nested 
within the wire command. 


Allows the display of wires to include buses and pat- 
terned lines. 


Automatically draws a wire between two selected 
points. 


Allows you to set default wire options. 


Temporarily highlights all wire connections in your 
design. 


Section 3 (Creating a Design) of the ValidGED User’s 
Guide contains more information about adding wires 
to a drawing. 
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write Writes the current drawing onto the disk. 


SYNTAX f 


write [[<dir>] [drawing_name] [. [type] [. [version] [.[ page]}}]] 


<dir> The SCALD directory where the drawing resides. If 
no directory is given, the drawing is written to the 
SCALD directory from which it was retrieved. If the 
drawing is a newly created drawing and no directory 
is given, the drawing is written to the current 
directory. 


drawing_name The name of the drawing to write. If no drawing 


name is specified, the drawing is given the drawing 
name specified on the status line at the top of the 
display. If you enter a drawing name and a drawing 
with that name is already in a SCALD directory, a 
warning message is displayed. Select write again to 
overwrite the existing drawing with the new drawing. 
Select any other command to cancel the write 
command. 


.type.version.page The drawing type, version number, and page of the 
specified drawing. 
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write 


Saves the current drawing named on the status line in 
the current SCALD directory. 


write newname 


Stores the current drawing named on the status line in 
the current SCALD directory. If a drawing named 
newname already exists, a message is displayed. Type 
or select a semicolon (;) to overwrite the existing draw- 
ing, or type abort, or select any other command to 
cancel the write. 


write <project2.wrk> 


Writes the current drawing into the SCALD directory 
project2.wrk. 


See Also 
diagram Allows you to rename a drawing. 
exit Leaves the editor. 
library Specifies the component library to be accessed. 
quit Leaves the editor. 
set The check_on_write option automatically calls the 


check command when the write command is issued. 


use Specifies a working directory. 
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zoom Reduces and enlarges portions of the drawing. 


zoom [option] 


SYNTAX = 


The zoom command is used to change the view of 
the drawing on the screen. This command can be 
used with up to three arguments. If there are fewer 
than three arguments, the command must be termi- 
nated with a semicolon. You can either select the 
semicolon box from the on-screen menu with the 


cursor or type a semicolon followed by a (Return). 


option The zoom command options are shown below: 


zoom ; If you issue the Zoom command followed by a semi- 
colon, GED redraws the image without changing the 
center or the scale. This option refreshes the screen 
when error messages cover part of the drawing. 


zoom down Reposition the center of the screen down below the 
drawing (move the drawing up on the screen). 


zoom fit Fits the drawing to the entire screen. 
zoom in Enlarge the size of the drawing on the screen. 
zoom left Reposition the center of the screen to the left of the 


drawing (move the drawing right on the screen). 
zoom out Reduce the size of the drawing on the screen. 
zoom previous Switch from the current zoom scale and position to 


the previous zoom scale and position. 
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zoom pt The zoom command with an argument of one point 
pans the drawing and causes that point to become 
the center of a new screen display of the drawing. 
The scaling of the drawing remains the same. Use 
the blue button to enter the single point. 


zoom pt? pt2 The zoom command with an argument of two points 
defines a rectangle with the specified points at oppo- 
site corners. The rectangle expands to fill the 
screen, providing a close-up view of the specified 
portion of the drawing. 


zoom pt? pt2 pt3 You can issue the Zoom command with three points. 
The first point defines the new center of the drawing 
and the display becomes either larger or smaller, 
depending on the ratios of the distances between the 
other points. If the distance between pt] and pt3 is 
greater than the distance between ptl and pt2, the 
items appear larger; if the distance is smaller, items 
appear smaller. 


zoom right Reposition the center of the screen to the right of the 
drawing (move the drawing left on the screen). 


zoom scale_factor You can specify an integer or a real number as the 
argument to the Zoom command to scale the view of 
the drawing by the amount entered. The center of 
the window remains the same. 


zoom up Reposition the center of the screen up above the 
drawing (move the drawing down on the screen). 


Some of the zoom commands may be pre~assigned 
to function keys, depending on your system. 
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zoom 2 


Makes the drawing appear twice as large. 


zoom —2 


Reduces the drawing by a factor of two. 


zoom 1.5 


Enlarges the drawing one and a half times. 


zoom 0.5 


Has the same effect as zoom -2. 


See Also 


window Changes the view of the current drawing. 
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abbreviating 
commands, x 
library names, 76 to 77 


accessing the operating system, 129, 
131 


add command, 2—4 


adding 

arcs, 23—24 

bodies, 2—4 

circles, 23—24 © 

dots, 11, 45 

drawings to drawings, 104 — 

libraries to search lists, 74 

objects to groups, 71 to 72 

path properties, 11, 21 to 22 

physical information to designs, 
12 to 19 

properties, 91 to 93 

text to drawings, 55, 84 

wires to drawings, 140 to 141 


arc command, 5 to 6 


arcs 
adding, 23 to 24 
drawing, 5 to 6 


arguments, command, xi 


assign command, 7 to 10 
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Index 


Index 


assigning 
colors, 85 to 86 
function keys, 7 to 10 
physical parts, 107 to 108 


attaching 
properties, 91 to 93 
signal names, 119 to 120 


auto command 
dots, 11 
path, 11 
undot, 11 


automatic wiring, 103 


B 


backannotate command, 12 to 13 


bodies 
adding, 2 to 4 
mirroring, 79 to 80 
rotating, 125 
sectioning, 107 to 108 
smashing, 123 to 124 
spinning, 125 


body versions, 135 to 136 
bubble command, 14 
bus name syntax, 16 


busname command, 15 to 17 


Index 


C connections, indicating, 45 
connectivity, checking, 21 to 22 
copy command, 27 to 31 


copying 


case-sensitivity, x 
change command, 18 to 20 


ae cut buffers, 87 
wi : 
objects, 27 to 31 
displays, 39 to 44 J 
names, 35 to 36 creating 
views, 137 to 139 drawings, 47 to 49, 58 to 59 
menu commands, 78 mirrored bodies, 79 to 80 


ipts, 75 
check command, 21 to 22 ree i . = 
cut buffers, copying, 
checking connectivity and errors, . PyIng 


21 to 22 cut command, 32 to 33 
circle command, 23 to 24 D 
circles 
adding, 23 to 24 debugging, 46 


drawing, 5 to 6 default colors, establishing, 85 


colors ; 
assigning, 85 to 86 defaults, setting, 110 to 115 
establishing defaults, 85 defining groups, 109 
combining objects, 64 to 65 delete command, 34 
command deleting 
abbreviations, x drawings, 97 to 98 
arguments, xi objects, 34 
entry, x designs, backannotating, 12 to 13 
file, 105 to 106 : 
syntax, xi diagram command, 35 to 36 
variables, xi directories 
comparing listing, 37 to 38 
logic designs and layout drawings, 73 specifying, 132 to 133 
signal names, 73 directory command, 37 to 38 
connect command, 25 to 26 display command, 39 to 44 
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displaying 
drawing information, 116 to 118 
errors, 51 
grids, 61 to 63 
objects, 39 to 44, 83 
script messages, 46 


documentation conventions, xii 
dot command, 45 


dots 
adding, 11, 45 
removing, 11 


drawing 
arcs, 5 to 6 
circles, 5 to 6 
names 
changing, 35 to 36 
listing, 37 to 38 


drawings 
added to other drawings, 104 
adding text, 84 
changing views, 137 to 139 
creating, 47 to 49, 58 to 59 
deleting, 97 to 98 
displaying information, 116 to 118 
editing, 47 to 49 
enlarging views, 144 to 146 
plotting, 66 to 67, 134 
printing, 66 to 67 
reducing views, 144 to 146 
removing, 97 to 98 
replacing versions, 60 
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Index 


drawings (continued) 
returning to previous, 101 
saving, 142 to 143 
smashing, 104 
wiring, 140 to 141 
writing, 142 to 143 


E 


echo command, 46 
edit command, 47 to 49 
editing 
drawings, 47 to 49 
sessions, ending, 94 


ending 
editing sessions, 94 
simulator sessions, 50 


endsim command, 50 

enlarging drawing views, 144 to 146 
entering commands, ix 

error command, 51 


errors 
checking for, 21 to 22 
locating, 51 


establishing default colors, 85 
exclude command, 52 to 53 
exit command, 54 

exiting GED, 54, 94 


Index 


F | 


fllenote command. 55 ignore command, 69 to 70 
ignoring items in search lists, 69 to 70 


2 ; 7 
find command, 56 to 5 include command, 71 to 72 


fixing mistakes, 130 


including 
format command, 58 to 59 objects in groups, 71 to 72 
; text files, 55 
formatting by eee oa : 
new drawings, 58 to 59 indicating connections, 45 
plots, 134 interactive script operations, 75 


interprocess communications, 25 to 26 
interrupting GED, 88 


G L 


function keys, assigning, 7 to 10 


get command, 60 led command, 73 
; libraries 
I 
Berne eps OF abbreviating names, 76 to 77 
grid display, 61 to 63 adding to search lists, 74 
grid command, 61 to 63 library command, 74 
group command, 64 to 65 line editor, 18 to 20 
: listing 


groups directory contents, 37 to 38 
se le drawing names, 37 to 38 
ane 1 i. loadmenu command, 75 
including objects, 71 to 72 locating errors, 51 
removing items from, 52 to 53 Ml 


H masterlibrary command, 76 to 77 
menu command, 78 
hardcopy command, 66 to 67 mirror command, 79 to 80 
help command, 68 mistakes, fixing, 130 
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modifying 
menus, 78 
text, 18 to 20 


move command, 81 to 82 


N 


names 
drawing 
changing, 35 to 36 
listing, 37 to 38 
pin, 15 to 17 
signal, 15 to 17 


next command, 83 
note command, 84 


O 


objects 
combining, 64 to 65 
copying, 27 to 31 
cutting, 32 to 33 
deleting, 34 
displaying, 39 to 44, 83 
finding, 56 to 57 
grouping, 64 to 65 
moving, 81 to 82 
painting, 85 to 86 
pasting, 87 
removing, 34 
repositioning, 128 
rotating, 102 
selecting, 109 


showing information, 116 to 118 


splitting, 126 to 127 
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Index 


on-line help, 68 
operating system, accessing, 129, 131 


p 


paint command, 85 to 86 
parts, replacing, 99 to 100 
paste command, 87 


path properties, 21 to 22 
adding, 11 


patterns, searching for, 56 to 57 
pause command, 88 
pausing GED, 88, 122 
physical parts, assigning, 107 to 108 
pin names, 15 to 17 
pins 

bubbled, 14 


swapping, 89 to 90 

unbubbled, 14 
pinswap command, 89 to 90 
plotting drawings, 66 to 67, 134 
previous operations, undoing, 130 
printing drawings, 66 to 67 
properties 

attaching, 91 to 93 

copying, 27 to 31 

path, 21 to 22 


reattaching, 95 
soft, 12 


property command, 91 to 93 


Q 


quit command, 94 


Index 


R | scale command, 104 
screen editor, 18 to 20 


reattach command, 95 i 
comman script command, 105 to 106 


reattaching properties, 95 . 
& prop scripts 


redo command, 96 creating, 75 
reducing drawing views, 144 to 146 displaying messages, 46 
remove command, 97 to 98 search lists 
: adding libraries, 74 

neONNS ignoring items, 69 to 70 

dots, 11 . 

drawings, 97 to 98 searching for patterns, 56 to 57 

items from groups, 52 to 53 section command, 107 to 108 

objects, 34 sectioning bodies, 107 to 108 
replace command, 99 to 100 select command, 109 
replacing selecting 

drawing versions, 60 alternate body versions, 135 to 136 

parts, 99 to 100 objects, 109 
repositioning objects, 128 separating vertices, 126 to 127 
return command, 101 set command, 110 to 115 
returning to previous drawings, 101 defining default colors, 85 
reversing undo operations, 96 setting 

default colors, 85 
rotate command, 102 defaults, 110 to 115 
ae spe show command, 116 to 118 
odies, , tal ; 
obj cae 102 showing object information, 116 to 118 


signal names, 15 to 17 
attaching, 119 to 120 
routing wires automatically, 103 comparing, 73 
signame command, 119 to 120 


Ss simulate command, 121 
saving drawings, 142 to 143 Simulator, ending sessions, 50 


route command, 103 
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sleep command, 122 
smash command, 123 to 124 


smashing 
bodies, 123 to 124 
drawings, 104 


soft properties, 12 

specifying directories, 132 to 133 
spin command, 125 

split command, 126 to 127 
stopping GED, 122 

substituting parts, 99 to 100 
swap command, 128 


swapping 
pins, 89 to 90 
positions, 128 


syntax, bus name, /6 
system command, 129 


T 


temporary interrupts, 88 


text 
adding to drawings, 55, 84 
modifying, 18 to 20 


U 


unbubbled pins, 14 
undo command, 130 
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unix command, 131 

use command, 132 to 133 
user input tokens, 75 

using directories, 132 to 133 


V 


variables, command, xi 

vector plot format, 134 
vectorize command, 134 
version command, 135 to 136 


versions 
body, 135 to 136 
drawing, replacing, 60 


vertices, separating, 126 to 127 
viewing drawings, 137 to 139 


W 


wildcard characters, 37 

window command, 137 to 139 
wire command, 140 to 141 
wires, routing automatically, 103 
write command, 142 to 143 


Z 


zoom command, 144 to 146 


